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NEXT 
MONTH 


We have on line a comparison of three 
well-known wordprocessors from a 
historic and user's perspective, the 
second part of Howard Clase's New 
Uses for Abacus, some more games 
and utility reviews, and some 
programming. 


or the past month or so, my system 

has been back to its basic 

configuration, without hard disk, 

but now it has a new Miracle hard 
disk unit (the old one went astray some- 
where after being serviced). There is a 
quite considerable improvement in work- 
ing comfort with the new one; it is much 
quieter than the old, mainly through hav- 
ing only one fan running. It is still mounted 
on a slab of foam rubber, but there is now 
little reason to complain; all hard drive 
units are likely to be somewhat noisy, 
because the drive needs a fan for cooling. 
| Recent versions of the Gold Card have 
included modified software that provides 
better handling of hard disk subdirectories; 
for users who run several programs from 
subdirectories, this feature makes a big 
improvement in the usefulness of the hard 
disk, and it will be useful with the higher- 
density floppy drives too. The rom version 
inthe GC should be 2.22 or later for proper 
operation of ED (extra-high density) drives. 


All Formats 


The All-Formats Computer Fair in Lon- 
don on 3 November was as well patron- 
ised as any of the previous fairs, and the 
QL suppliers looked to be doing reason- 
ably well. DJC, EEC, TF Services, Miracle 
Systems, Quanta and Digital Precision 
occupied most of one corner, as usual. It 
somehow does one good to see new QLs 
appearing out of the familiar silver boxes 
after all these years. Digital Precision had 
the Perfection Spelichecker program on 
show, and the speed of it obviously sur- 
prised onlookers. Regardless of file or 
dictionary size, most spelling checks take 
seconds rather than minutes to complete. 
Incorporation of 'new' words into a diction- 
ary is a separate process, but it doesn't 
take long. The Gold Card now has a red 
pcb and incorporates some minor changes. 
From about version 2.21, the rom has 
included software changes from Tony 
Tebby, such as the DEV function, which 
allows eight subdirectories to be treated 
as individual devices; this makes it possi- 
ble for programs which accept only the 
basic five characters (eg flp1_) when de- 
faults are configured to utilise sub-direc- 
tories with longer names. TF Services was 
doing a good trade in ZX8301 chips and 
had its small QL-controlled robot on display. 
The latter has asimple interface and seems 
a good device for teaching children the 
elements of ‘robotics’. 


Bryan Davies looks at 
Spellchecker and a box 
of Miracle hardware. 


In case you haven't been reading the 
Digital Precision ads recently, note that 
some of the better programs previously 
sold by PDQL have resurfaced. These 
programs have mostly been updated since 
they were last supplied by PDQL. The 
pride of the collection has to be either 
CPort or Cash Trader, depending upon 
your orientation. The former is a relatively 
painless transformer of SuperBasic pro- 
gram code into C-language code. The 
latter is a home- and small-business ac- 
counts-keeping system. Both are working 
programs; that is, they appeal primarily to 
users who have work to do, rather than 
those who are looking for amusement. 
Neither demand any high level of technical 
knowledge from the user. ; 

The program which has occupied most 
of DP's time during late summer is the 
Spellchecker portion of the Perfection WP 
program. Spell-checking tends to be an 
add-on facility, and this one started out 
that way, but it became a major undertak- 
ing in its own right. The problem was not 
simply writing the necessary program code 
— although that was a fairly big task — but 
to decide upon the 'smarts' which had to go 
into it to enable checking to be very fast 
with a very large word list. You are unlikely 
to come across a larger word list than the 
one labelled ‘Mega’ by DP; it presently 
holds about 360,000 words. In the course 
of developing the various word lists on 
offer with Spellchecker, several competi- 
tive or comparable offerings were looked 
at, the largest claiming to have going on 
half a million words. It was found that some 
of the lists contained many ‘words’ which 
would have baffled dictionary experts, and 
the effective totals were much lower than 
the stated ones. The ordinary mortal will 
still find a large number of the words in the 
Spellchecker lists unusual, to say the least, 
but we are assured that they are genuine, 
having been thoroughly cross-checked 
against several reference works. Here are 
a couple of statistics sufficient to make 
most of us choke — the supplied dictionar- 
ies have limits of 32,767 words for any one 
letter of the alphabet and about 34 letters 
for any word. If these limitations cause you 
problems, you may well have a sizeable 
problem yourself! 


The largest of the Spellchecker word lists 
occupies over 1 MB ina compressed form, 
the percentage compression from full size 
being 60-70%. In terms of numeric sizes 
1990 has seen the QL world take a large 
step forward — 12 MB of ram, 16 MHz cpu 
speed, 3.2 MB floppy disk capacity (all 
courtesy of Miracle Systems). One thing 
that has stayed pointedly unchanged is 
the screen resolution of 512 x 256 pixels. 
The QL emulator which runs on the Atari 
ST has gone well past that, with support 
for 768 x 280 (3207). Inthe PC world, 1024 
x 768 is becoming relatively common. 
Presumably, a significant increase in reso- 
lution means a new display unit, and that 
means a fair amount of money, but users 
have shown that they are willing to pay for 
more memory, a faster processor, hard 
disk, and higher-capacity floppy drives. 
Can the QL be made to drive any of the 
host of higher-resolution displays which 
are available at reasonable prices for PCs? 


Large box 


Just as this article was being completed, 
a large box arrived from Miracle Systems. 
It contained dual ED (extra-high density) 
floppy disk drives and a 4-drive adapter. 
Things rarely go as smoothly as one would 
like, but thisinstallation went withouta hitch. 
The ED drives were plugged-into the up- 
wards-pointing connector on the adapter, 
the existing dual DD drives were plugged- 
into the straight-out connector, and a 3-pin 
plug was put on the mains supply cable. 
When the system was switched on, all 
drives worked fine; the ED ones are flp1_ 
and flp2_, the DD ones flp3_ and flp4_. 
Note that no changes whatsoever were 
made to jumper settings in the drives, or to 
software. The system already had Gold 
Cardand hard disk connected; there are a 
few things to sort out concerning them—eg 
neither Professional Publisher nor Con- 
queror worked from hard disk initially — but 
these problems, should be sorted out in 
time for further comment on ED drives in 
next month's issue. 


Readers’ letters 


First, another request — don't send blank 
cheques to suppliers! Yes, some people 
do this, and it may be a sign of their faith in 
the supplier, but it would be better to insert 
wording to the effect ‘valid up to a maxi- | 
mum of £x' (insert the highest figure you 
think the goods will cost), if you are not 
sure of the exact amount. Think what 


Sinclair/QL World February 1992 


eecRRORORIEE 


might happen if a blank cheque got 
stolen. ... 

Eros Forenzi of the Qltaly Club (see 
INFORMATION below) mildly takes me to 
task for being less than enthusiastic about 
Qpac, and suggests | give it another try. 
This | have done, several times, each time 
deciding to go back to the simpler way | 
normally do things. The same thing is 
currently happening to me on the PC, 
where Windows (which has quite a bit in 
common with Qpac) has convinced me to 
stick to the text-only (that is, non-graphi- 
cal} interface. It is not a question of being 
a computer luddite in the matter ~ | have 
long thought that a better, more intuitive 
user interface was needed and that it 
would have to be (in some way) 'graphi- 
cal', but | had not realised until using these 
two utilities the price the user has to pay in 
terms of additional actions, memory and 
time, on both QL and PC, to gain the 
advantages of the graphical interface. 

From what | read, it looks possible that 
the Macintosh with System 7 and the Next 
computer provide a much better way of 
handling interaction between computer and 
user, but they are in adifferent price league. 
Some years ago, | also rejected Taskmas- 
ter as my permanent ‘supervisor’ utility, 
largely because it is a memory hog (as is 
Qpac), but the advent of the Gold Card 
means that one can be rather profligate in 
allocations of ram so, maybe, something 
like Taskmaster could have a future. 

After a few years of battling with a mutitude 
of new programs, each with their own 
idiosyncrasies in the methods of actuating 
functions, one tends to get rather tired of 
having to ‘go back to school’ for each new 
arrival. It may sound like heresy to pro- 
grammers, but some users actually want 
programs to be usable without requiring 
the reading of a heavyweight instruction 
book, the writing of an extensive boot 
program, and the burning of midnight oil 
for several weeks. By andlarge, Taskmas- 
ter is straightforward going, the keying for 
programs is simple and memorable, and 
operation is snappy; being afew years old, 
it could do with some face-lifting, and | 
must admit to still liking the desktop ap- 
proach of /ce, so a choice of keyboard or 
mouse control would be desirable to me. 
What | am, perhaps, saying is that there 
seems a need for something with the es- 
sence of Qpac, but with a more ‘human’ 
face to it. 

We are presently rejoicing in the way the 
Gold Card has made operation of existing 
programs so much better, but bear in mind 
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that Miracle have already demonstrated a 
speed-up board with a 68020 cpu (a step 
up from the 68000 in the GC), and are 
almost certainly considering the possibili- 
ties of using the 68030 or 68040; boosting 
the QL with these cpus would put the QLin 
a state where the software was lagging 
badly behind the hardware. 

Eros sent me two disks containing two 
issues of the Qitaly Club magazine and 
said that 19 issues have been produced 
since formation of the club in February 
1989. That's a good record, and he says 
they expect to keep it up. The two issues 
he sent me were very well produced and 
displayed a professional attitude, for ex- 
ample in the drawing of the opening 
screens; the disks have a boot file, so the 
user needs do no more than pop them into 
flp1_ and boot up. More comment on this 
form of magazine next month, when I've 
had time to go through these two issues. A 
forthcoming issue is planned with just Qpac 
as the subject, and written in English; send 
me a copy of that one, too, please. 


Four drives 


H.R. Banks has had some difficulty get- 
ting four floppy drives working together, 
on his QL(s) with Trump Card and Gold 
Card. There may be some problem mixing 
DD and HD drive pairs. This has to be 
checked but Miracle have, in the mean- 
time, replaced a pair of Banks' DD drives 
with HD ones. As noted above, my own 
system now has ED and DD drives work- 
ing happily together off a GC. 

The mention of cut-and-paste operations 
inaprevious issue prompted Peter Hamill 
to mention that he has transferred data 
from Archiveto Perfectionwithouttoo much 
bother, but my impression is that the proc- 
ess is too difficult for relative novices. You 
can always copy part of a loaded file from 
one program into temporary storage in a 
ram disk, then import it into another pro- 
gram; provided the first program can put 
the file into an Ascii text form when send- 
ing it to the ram disk, or the second pro- 
gram has a suitable text-only import func- 
tion, you have a form of cut-and-paste. 

What | was visualising is a much simpler 
process (for the user, but not for the pro- 
grammer); a supervisor program — eg 
TaskMaster, Q_Switch, Qpac — that could 
take a snapshot (like a screen dump) of all 
or part of the information on the screen of 
the first program, put the information in 
memory and hold it automatically, allow 
you to switch to the second program, put 


the cursor where the information needs to 
be inserted, then ‘paste’ the information 
there. 

There are various drawbacks to the im- 
plementations ofthis idea that | have used, 
but none of them render the operation 
useless. One version will ‘grab' nothing 
less than the whole screen — menus, sta- 
tus lines and all — but the surplus can be 
deleted with the normal editing keys when 
the information is dumped at its destina- 
tion. As it is screen information that is 
being grabbed, it is hardly surprising that 
functions which were used to produce the 
screen display in the first place, such as 
tabs and codes for bold, changing fount 
etc, get lost in the transfer; typically, this 
also happens when text-only transfers of 
files are made via disk files. The best 
method I've seen succeeds in transferring 
text or graphics, and (some of) the format- 
ting codes, with only simple key combina- 
tions being needed for the cut and paste. 

Problems with printer ribbons must be 
widespread, and Stanley Hurwitz was 
not telling me anything new when he re- 
lated the problems he has with ribbons for | 
his Panasonic KX-P1124 DMP printer. If 
you find close on £10 too pricey for a 
‘pranded' ribbon, the only choice seems to 
be to pay about £3 and get a ‘pattern’ 
ribbon of much lower quality. The usual 
trouble with such ribbons is that they wear 
badly, and quickly, at the point the ends of 
the ribbon are joined together (usually ata 
roughly 45° angle}. A hole appears at the 
join, and characters are unprinted if the 
action of the print pins coincides with ar- 
rival of the hole. Presumably, there could 
be damage to the print pins in unfavour- 
able circumstances, such as when the 
hole gets particularly bad. My own attempt 
to solve this problem, by asking the suppli- 
ers for an intermediate-quality ribbon, got 
me nowhere. They didn't have such a 
thing, and supplied me a branded ribbon, 
which hasn't exhibited this problem, cer- 
tainly, but prints rather fainter than the 
‘cheapies' do. Itwasn'tworth the money. In 
earlier years, the cheap ribbons for my 
Kaga-Taxan (Canon) DMP were quite good 
and not too prone to producing holes; my 
practice was to re-ink these and branded 
ribbons, but there was a tendency for print 
density to vary quite considerably. Has 
anyone found a source of decent-quality 
ribbons for the KX-P1124, at between £3 
and £6? 

Good news from A. Ingrey, who got both 
areplacement keyboard and interface fram 
EEC Ltd. anda refund from his credit card 


company! Hopefully, the money side has 
been sorted out by now. He has an unu- 
sual problem with disks, thathas appeared 
since he installed a Gold Card, although 
that may be pure coincidence. The disks 
in question hold letters which have been 
written over almost a year, and they now 
appear to be unusable asa result of some 
form of directory corruption. There are 
over 100 files on the disks, and Ingrey 


Experiment 


wonders if that is too many. The basic 
answer to that is 'no’, but the size of the 
files does matter. 

As an experiment, I've copied close to 
500 files onto. one 720 KB floppy; the 
experiment was terminated by the ‘drive 
full’ message. There was no sign of cor- 
ruption, but the files were all founts, occu- 
pying less than 1 KB each, and couldn't 
easily be checked for correctness. The 
possible technical explanation of what 
happened on Ingrey's disks is something 
that has been put to me in the past, but 
some of the detail has got lost in my 
memory banks. Essentially, the story was 
that itis possible to have a certain number 
of files sitting on a disk, occupying almost 
all the space but giving no trouble, until 
one of the files is modified and increased 
in size. The directory space for that file will 
already have been allocated, at a time 
when directory allocation space and file 


space did not exceed the available space 
on the disk; then, the file is increased in 
size so that there is insufficient room for it. 
Presumably, what oughtto happen is that 
something — Qdos — recognises the po- 
tential danger and refuses to start the 
save process which will end up with the 
drive full and the file incomplete on disk. 
The user should be warned to save to 
another disk, before the existing file or — 
much worse — the directory, get corrupted. 

As for a way of avoiding such a problem 
in future, the only obvious point is that the 
process of regularly saving files with the 
same names, but increasing sizes, is what 
leads to the trouble. You don't get it by 
simply copying a lot of files at the same 
time. Maybe he should use one disk for 
saving current documents (not taking up 


Data file 


most of the disk), and transfer these to 
archive disks at intervals, when the files 
are in their 'final’ state. 

Apropos of saving SuperBasic program 
files from Perfection, Martin Wheatley 
suggested creating a special printer_data 
file for the purpose, rather than switching 
the line wrap function off. The file would 
have no entries other than LF for the EOL 
(end of line) code. DP do supply such afile 
with Perfection, under the name Null_ data, 
and it is no doubt successful for saving 
Ascii text files for export to other pro- 


grams, but it doesn't appear to solve the 
problem | spoke of a few issues back. If 
you edit an SB program file in Perfection, 
and use the ENTER key in doing so, that 
key puts a character — shown as a right- 
angled arrow when the CTR/-H command 
is used to display codes — and that ap- 
pears as a ‘splodge’ when the file is sub- 
sequently LOAD-ed from the SB com- 
mand line; that program line also has 
MiStake inserted after the line number. 
This is even though the file is saved by 
using the Print command and specifying a 


drive rather than the printer port as the | 


destination. I'll stick with switching line 
wrap off and using the Exportcommand to 
save the file. Martin gave the address 
(see INFORMATION) of his local Quanta 
sub group meeting place and recom- 
mended it for informal, social gatherings 
of QL users. 


INFORMATION 

Qlitaly Club (for lialian QL users): 
Eros Forenzi 

Via Valeriana 44 

23010 Berbenna (SO) 

Italy 

Tel: +39 (0342)-492323 


Quanta (London group): 

Meetings are held from 1900 hours on the 
second Wednesday of each month at the 
Prince George of Cumberland, 195 Albany 
Street, London NW1. 


ARGIRUWVE YOUR @ib 
GOLLEGITION 


Now you can keep your Sinclair QL 
World magazines safe and clean. No 
more dog-eared covers or missing 
copies .. . You can protect 
magazines in this high quality 
specially-created binder. This Sinclair 
QL World binder will comfortably hold 
a complete year’s issues of your 
favourite Sinclair magazine. It is a high 


quality product, British-made and 
comes with full binding instructions. It is 
manufactured in a rich, deep blue with 
i gonolte gold blocked lettering. 

; nhance your Sinclair QL World 
Magazine collection now for only 
£5.95 (inc.P&P!) Send for one today! 
The QL World binders also make an 
ideal gift for other Sinclair users too! 


I TO: QL WORLD MAGAZINE, PRINGLE STREET, BLACKBURN, LANCS BB1 1SA 


I Please send me [_] QL World binders — | enclose £5.95 for each binder including VAT. postage & packing. 
I Readers outside the UK and Eire please add £1.50 for surface overseas mail. 


| Please make cheques payable to M.C.P.C. Ltd 


I ACCESSL_]VISAL_Jaccount: 


Tel No. ........ 
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QL Scene (News) OL World 
Jurgen Falkenburg has pro- 
duced a new interface board 
for hard disk connection toQLs 
via PC hard-disk controllers. 
Dubbed the QL-HDD-Card, 
the interface was shown in a 
system running a reliable 20 
MB hard disk in London in 
November. 


Port 


The QL-HDD-Card uses the 
QL expansion port to commu- 
nicate with a standard PC hard 
disk controller (which can be 
ordered as an optional extra), 
which allows connection of an 
MFM- (controller type OMTI 
5520 or WD 1002A-WX1) or 
RLL- hard disk (controller type 
OMTI 5527, WD 1002-27X or 
1002A-27X) to the QL. The 
driver, win_1,isincluded inan 
on-board eprom, and is inde- 
pendent of the hard disk being 


Quanta is to hold an Extraordi- 
nary General Meeting (EGM) 
at 2pm on 16 February 1992 at 
Rayne Village Hall, Gore Road, 
Rayne, Essex. The subject un- 
der discussion will be the 
position of traders serving on 
the Quanta committee and the 


Amiga 
Emulator 


Qubbesoft PD can now offer 
the software QL emulator for 
the Amiga. For more informa- 
tion contact Qubbesoft PD, 38 
Brunwin Rd., Braintree, Es- 
sex CM7 6BU. Tel. 0376 47852. 


possibility of conflict of inter- 


used. Any hard disk, says 
Falkenburg, is supported, even 
with more than 100 MB. 

The main advantages of hard 
disks are much greater storage 
capacity and much faster disk 
access. 

The OL-HDD-Card can be 
supplied alone, witha control- 
ler and hard disk, or as a com- 
plete system with the control- 
ler, hard disk and power sup- 
ply. Being modular, the sys- 
tem is very flexible for QL us- 
ers who have re-cased their QL 
systems. 

For further flexibility, the 
Card can be adjusted by 
switches to any rom address in 
the OL memory, including one 
of the 16 upper rom slots from 
$C0000 upwards. The manual 
describes the addressing proc- 
ess in detail, and it is designed 
to be done without a deep 
knowledge of Qdos. 


JES CENE! 


New hard disk interface from Falkenburg 


The Card also supports real 
subdirectories. Switches may 
also be added to file names to 
allow subdirectory operations 
straight from the Psion pro- 
grams, using short paths with 
level-2 drivers. 


Dubious 


The Card does not support 
through-porting of the expan- 
sion support, because this is 
regarded by many designers 
as dubious electronic practice. 
If more than one peripheral is 
to be used, Falkenburg recom- 
mends a bus expander, or his 
own QL-BUS-Driver with five 
card sockets as standard. 
However, Falkenburg also 
notes that the QL-HDD-Card 
is 125 mm in width and does 
NOT fit directly into the ex- 
pansion slot of a QL in its 
original case. It will fit directly 


est, after a series of proposals 
submitted by QView’s 
Jonathan Oakley. 


Proposals 


Ron Dunnett, Quanta’s gen- 
eral secretary, who runs 
Qubbesoft PD public domain 
service, said “I think that some 
of the proposals are probably 
unworkable but some of them 
are very sensible. When [joined 
the committee, I declared all 
my interests to Quanta, and if 
anything was handed to me 
that I thought would cause a 
conflict of interest, would pass 
it straight over to Phil.” 

To call an EGM, the proposer 
must present a petition with at 
least 25 signatures, which the 
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Quanta questions traders’ role 


Committee will then consider, 
and callan EGM if they believe 
there is a suitable case to do so. 

Long-time committee mem- 
ber Dennis Briggs of Adman 
Services resigned from the 
committee at the Nottingham 
Workshop last October. 

For more information about 
the EGM, contact Ron 


Dunnett, 38 Brunwin Rd., 
Rayne, Braintree, Essex CM7 
5BU, or Phil Borman, 1 New- 
ton Rd., Raunds, Northants. 
NN9 6LX. 


Another 


to the through-port of a ram 
expansion board, or in a QL- 
BUS-Driver socket supplied by 
JFC. 

The QL-HDD-Card special 
adapter for the rom port for 
Gold Card users will be avail- 
ableshortly. Currently the QL- 
Bus-Driver cannot be used 
with a Gold Card. 

The QL-HDD-Card export 
price (for customers outside 
Germany) is DM 219, or DM 
351 complete with MFM- or 
controller, Information leaflets 
are available, and both infor- 
mation and products can be 
obtained directly from Jurgen 
Falkenburg (JFC), Thanweg 
36, D-7539 Ersingen, W. Ger- 
many. 
or from the UK distributor 
EEC Ltd., 18-21 Misbourne 
House, Chiltern Hill, Chalfont 
St. Peter, Bucks SL9 9UE. Tel. 
0753 888866. 


PD service 
launched 


Anew publicdomain software 
service has contacted QL World. 
SJPD,run by Stephen Jacobson, 
is offering around 30 disks of 
public domain software at a 
copying price of £1 per disk. 
Blank disks can also be sup- 
plied at 50p each. A disk of 
samples is available to anyone 
sending a blank disk, self-ad- 
dressed label or envelope, and 
return postage, whichis a very 
fair offer. Writers to contribute 
new software are also sought. 

Interested parties should 
contact Stephen Johnson at 36 
Eldwick St., Burnley, Lancs 
BB10 3DZ. 
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Oren Buannes 


Open Channel is where you have the 
opportunity to voice your opinions in 
Sinclair QL World. Whether you want to ask 
for help with a technical problem, provide 


Iread withinterestC A Bland’s 
letter in the July QL World. I 
agree that Discover should solve 
the problem. 

IT run two QLs, one at home 
and one for my general work 
in the office. [am a public rela- 
tions consultant and compose 
press release drafts on my QLs. 
Final copies of everything are 
produced on an IBM-compat- 
ible, and I find MultiDiscover 
indispensible for converting 
my Quill files to the IBM for- 
mat. 


operation! 


Better news: Dave Walker has been in touch to 
say that release 2 of the C68 Public Domain C 
Compiler will be issued just after Christmas. In 
other words, just about the time you read this. 


Happy New Year! 
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Editor’s notebook 


First , thank you to those who responded to the 
appeal for reviewers in the December issue. 
More good news: Bruce Everiss, founder of the 
All Formats Computer Fairs, has kindly allowed 
us to print a £1-off ticket for QL World readers 
attending a fair in the spring. That should appear 
in QL Scene next month. Check with Miracle, DP 
or EEC, or any other favourite supplier, to see 
which fairs they will be attending. 

Not such good news: we have had to postpone 
the ‘post-Christmas-present’ article through 
pressure of time and low response. It seems 
some people are dubious about plugging other 
people's products! Come on, let's have some co- 


Ihave been using Textidy and 
Multi since October 1989, ini- 
tially to transfer Quill files toa 
CPM format. At the time our 
main office system was CPM- 
based, hence the use of Multi. 
Also I write material for our 
local church magazine, which 
is put together using Fleet Street 
DTP. Converting files to this 
have been no problem. 

Recently I changed our office 
system to an AST Bravo 286. 
Again, using Multi presented 
no problems. The 286 will 
shortly be changed to a 386, 
and I am anticipating no prob- 
lems with that either. 

I do not use Easel, but | have 


somebody with the answer, or just sound off 
about something which bothers you, write 
to: Open Channel, Sinclair QL World, 
116/120 Goswell Road, London EC1V 7QD. 


converted Abacus files to both 
CPM and IBM formats. 

I mentioned Textidy earlier. I 
find that I need this to strip out 
some of the hidden Quill com- 
mands to minimise editing on 
the IBM. Textidy and Discover 
are easy to use and have simi- 
lar formats, both being written 
by Dave Walker. I needed to 
talk to him in the early days 
because our CPM was an ‘odd- 
ity’, in that it was an Olympia 
Olytextsystem developed from 
Olympia’s electronic typewrit- 
ers. Dave sorted things out for 
me and altered Multi’s format- 
ting procedure to cope with 
the unusual. As a result this is 
now astandard optionin Multi. 
Dave Walker's software is now 
available from Dilwyn Jones 
Software. 

Keith Tearle 
Anderson Associates Ltd 
Sidcup 


COPY 


Surely Peter Tomlin is wrong 
to suggest that, in the Abacus 
interest table he designed (Open 
Channel October 1991), itis pos- 
sible to COPY rows 7 to 15 
from the March row (6) and 
then edit them. In doing so, 
every row will be edited. 

If the intention is to copy the 
whole block, each row must be 
copied in its entirety. If only 
one block is required, the sim- 
plest way is to precede D3, H4 
and J4 with the dollar sign ($) 
in both long formulae in row 5, 
changing the second one to: 


($D3+sum($]4:J5 *F5/1200)) 


Row 5 can then be copied to 
row 6, rows 5 and 6 to row 7, 
rows 5 to 8 copied to row 9 and 
rows 10 to 12 copied to row 13. 
The only editing required then 
will be the text in column C. 
Even that will be unnecessary 
if the formula: 


month(row( )-3)( to3) 


is typed in cell C4 and copied 
to C5. 

In designing spreadsheets, it 
is important to realised that 
cell references in formulae are 
translated into relative 
positional references (eg two 
up, one to the left) unless, in 
the case of Abacus, they are 
preceded by $or the index func- 
tion is used, 


P H Warne 
Newcastle Upon Tyne 


Numbers 


Despite Brian Storey’s contri- 
bution to Open Channel in the 
Aprilissue of OL World Istand 
by my remark that it takes 
about 30 lines of SuperBasic to 
avoid a Qdos error message 
when INPUTing numbers. 

My ideal criteria are: 1. No 
keyboard entry, however un- 
likely, should be able to cause 
the Program to crash. 2. Any 
numerical entry acceptable to 
the INPUT statement should 
pass, eg “ -3,45e +456 “ (with 
leading and trailing spaces). 

Ithink everyone would agree 
that the first must be satisfied, 
but the second is almost im- 
possible, and that is where Mr 
Storey and I are at cross pur- 
poses—heis satisfied with mere 
positive decimals, while I 
would like to get closer to the 
ideal. . 

Unfortunately, Mr Storey’s 
routine does not even satisfy 
criteria 1 —try pressing ENTER 
without any digits ora number 
with more than one decimal 
place (eg 2,3,4), and both will 
crash with a Qdos error. The 
listing supplied is the most 
compactuncrashable FuNction 
I could come up with that sat- 
isfies his definition ofa number. 
(Line number counts are not a 
really useful measure of excel- 
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lence, especially when multi- 
statement lines are used!) 

I think a FuNction is more 
appropriate thana PROCedure 
since it ‘returns a value’ and 
that is just what we want here, 
Lines 80 and 90 illustrate how 
the FuNction might be called 
from the main part of a pro- 
gram, The parameter is the 
channel number of the win- 
dow used by the INPUT 
statement. While the use of 
INSTR is one way to go, the 
SELECT ON structure com- 
bined with the use of CODE is 
easier to follow than a cascade 
of IF... THEN... ELSEs when 
a sequence of tests has to be 
made — and about twice as 
quick, too, 

The error flag, er, is set when- 
ever an error is made and there 
is also another flag, d, which 
only allows one decimal point 
(200). You can only get out of 
the loop at line 230 if no error 
has ben made. Coersion is im- 
plicit at line 250 when a string 
is RETurned by a floating point 
FuNction. The SELect ON 
structure can be expanded with 
more flags to deal with signs, 
exponential notation, spaces 
etc., but there is not room in 
Open Channel to give a full 
explanation. I have rewritten 
my original routine along these 
lines, reduced it to 29 lines, and 
it now accepts positive and 
negative numbers from 1E-600 
to9,999E+600, with leading but 
not trailing spaces. 

Howard Clase 
Newfoundland 


Ihave a QL with a Sandy SQ 
board and mouse port. I can’t 
find a mouse that works with 
it. Doesanybody know the kind 
of mouse I need? Does any- 
body sell it? 


Julian Colomina Gonzalez 
Madrid 
Spain 


Editor's comment: We're keeping 
Julian's letter on file and would 
like to hear straight from current 
users/vendors on this one. 


As a professional C program- 
mer, what I need is a compiler 
that saves me time and confu- 
sion, especially when I come 


back to look at code after six 
months. C has now developed 
as far as ANSIC, with function 
prototyping, enums, and 
standard libraries, as well as 
C++ with encapsulation, inher- 
itance, etc. | don’t mention 
these because I think I need a 
more powerful complicated 
compiler, but because these 
make it easier for the compiler 
to catch errors before the pro- 
gram is run, making it easier 
and quicker for me to produce 
and bug-free program. How 
about a SmallC++? 

Commenting on Trouble- 
shooter, it seems to me that what 
is really needed for the QL is a 
connection standard; in other 
words,anIBM-compatible PC/ 
AT bus, of which there are mil- 
lions in the world. This makes 
no difference to the QL Qdos 
environment or software, but 
would allow plugging in IBM 
standard hard disks, fax cards, 
modems, VGA cards, and so 
on (although QL rather than 
PC software drivers would be 
required). Monitors are more 
(or less) standard, mice are 
cheaply available for serial 
ports, so this would enable eve- 
ryone to concentrate on soft- 
ware on the only multi-tasking 
budget machine around. Not 
everyone can make a pcb in 
their basement, but everyone 
can have a go at a world-beat- 
ing program. 

Does nobody make an add- 
on box for the QL with an AT 
bus? 

Philip Kerrigan 
Milan 
Italy 


Editor's comment: there are a 
number of private projects going 
on quietly behind the scenes at the 
moment, which, quite rightly, the 
owners won't reveal until they are 
within sight of completion. Will 
one of these turn out to provide the 
type of link-up desired by Peter 
Kerrigan? 


Pink Vikings 


Having tried several times to 
read the article Valhalla Revis- 
ited in QL World March 1991, I 
have had to give up each time 
due to pink Vikings wielding 
axes, jumping across the page. 
Is there any possibility you can 
let me have a copy of the article 
without the embellishments? 
I do hope you do not repeat 
this underprinting exercise. It 
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may look pretty, butitis totally 

aggravating if one wishes to 

read thearticle. Yourcomments 
would be appreciated. 

A C Hill 

Newton Aycliffe 

Co. Durham 


Editor's comment: I assure you, 
my comments weren't appreciated 
at the time. We issue standing 
orders that back-prints are to be 
no more than 10% density. The 
Vikings should have been the same 
density as the pale blue strip on 
page 3 of the March issue, or the 
screen dump on page 20, but they 
are, as you can see, much darker. 
So somebody downstream of our 
office ‘improved’ on our design. 

And I still catch 20% and 30% 
back-prints trying to sneak past 
me, 

I will ask Simon Goodwin if he 
can do a printout of the article 
which we can send to anyone who 
sends us an SAE —and, of course, 
to Mr Hill for his efforts, rivalling 
those of Alfred the Great, in stop- 
ping the Vikings. 


Proliferation 


Irecently purchased Perfection 
from Digital Precision, and af- 
ter managing with Quill for so 
long I can only praise the DP 
program. 

Regarding the Justify func- 
tions (Capt. Eric Starling, QL 
World December 1991), you 
could type your address (or 
anything else) on the left of the 
page, then place the cursor at 
the top of the page, go to Menu 
2, press J, then Menu 2, press E 
(for reformat hEreon) and 
magically, your address will 
now be centred. 

Remember to alter the justifi- 
cation for the rest of your docu- 
ment. 

What! particularly like about 
the program is, it seems that 
you can do anything with the 
document and still get back to 
your original version. In Quill, 
the cursor and line formatting 
seem to have minds of their 
own, leaving the document in 
a mess. You then have to ex- 
periment to try and recover the 
situation to avoid re-typing 
whole sections. 

The handbook is large and 
comprehensive. I like the extra 
snippets of information that are 
dotted throughout for the likes 
of us who are not steeped in 
knowledge of computer terms. 

I was so impressed that I ob- 


tained the spelling-checkerand 

Lightning, and have now or- 

dered Professional Publisher and 

Eye-Q for easier production of 

notes with diagrams and draw- 
ings. 

Bryan Orgar 

Ashford 

Kent 


Editor's comment: One or two 
people have remarked that we seem 
to print a lot of letters praising 
Perfection. It's true: this is be- 
cause we get a lot of letters prais- 
ing Perfection. It has reversed the 
normal trend where a magazine 
only receives a run of letters if 
something goes wrong, and criti- 
cal/quizzical letters outnumber 
letters of praise. The last time we 
had a jot of this enthusiasm was 
after Lightning was released. How- 
ever, I remember the first time an 
employer of mine sat me down 
with Wordstar and said, learn this. 
After halfa day my emotions were 
a volatile mix of astonishment at 
its speed and power, and rage at 
its vast, labyrinthine, unending 
complexity. 

Perfection is comparable with 
office-standard PC systems like 
Wordstar, with an ease-of-use fac- 
tor nearer to Quill. Joy and aston- 
ishment would be a natural reac- 
tion. For those who have unex- 
pectedly encounted Rage—and we 
have had all of two, maybe three 
(there was a borderline case) vexed 
letters about some aspect of Per- 
fection —I can offer the comforting 
thought that the answer is usually 
very close at hand, and that if you 
were a PC user you might have to 
use WordPerfect. If in doubt, try 
the HELP document which is both 
comprehensive and compact. 

In conclusion, I would like to 
quote from a letter about the 
Spellchecker, which Freddy him- 
self waved at me after I commented 
that I had only seen it running on 
large QL systems. 

“Lam only using a fairly early 
and modest internal 512K expan- 
sion board, which I know is much 
slower than Trumpcard, but the 
speed of spellchecking is phenom- 
enal, and makes the concept of 
spellchecking on completion of a 
document the right one, as it is 
really quick and easy to use.” Per- 
fection Spellchecker does not have 
an auto-replace option for indi- 
vidual checked words, like large 
hard-disk-based systems — this 
would make it untenably large - 
but it is so fast that checking an 
average document is probably 
faster. 

Now I'm doing it. . . 
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DIGITISER REPORT 


Les Binns has 
been using 
his COV1 for 
several 
months and 
has found 
plenty of use 
for it. 


illing a gap in the UK QL market, 

the CQV1 is a reasonably priced 

digitiser at £120, and will appeal 

to QL users interested in desktop 
publishing or similar packages. It is an 
advantage if you already use a video cam- 
era but for those without access to one, 
images may be taken direct from a ver or 
other PAL video source, provided that 
due care and attentionis paid to copyright 
law! Capable of running onan unexpanded 
QL, the saved images can be treated in the 
same manner as QL screens, loaded into 
art or dtp software and manipulated or 
printed. 

The Digitiser is housed in a glossy black 
ABS plastic box 180 mm by 110 mm by 60 
mm high. Protruding from the lower edge 
of one long side is a double-sided fibre 
glass pcb edge-connector to fit into the QL 
rom socket. On the rear is a phono socket 
marked I/P, for the PAL video signal 
source input, and a small diameter red 
adjustment knob marked ‘B.LEVEL’ for 


The above 
from the digitiser 
The same picture 
has been loaded 
Publisher throvgh the Mode 8 
texture selection and printed 
after the addition of this 
The image was digitised from a 
Black & White negative wsing a 
video camera set to macro and 


picture was printed 
screen dump 
on the right 


into DP's Pro 


text 


white paper. 
command was 


The “negative* 

used to reverse the 
image to positive prior to 
as a screen 


saving 
image 


tungsten lighting, diffused through | 


User Report-cav i 


black level setting. It is guaranteed for 90 
days against faulty components and 
workmanship, and offers a choice of 3.5 or 
5.25 in disks or mdv for the controlling 
software, and an 8-page A5 manual. 

My first thought on examining the 
digitiser was that some people, myself 
included, who have built the QL into a 
KBL casing with drives and psu, would 
need to build a jumper lead to connect the 
rom socket to the unit. I had brought the 
rom socket to the rear of the casing but 
positioned it too high to allow direct fit- 
ting of the digitiser without placing the 
entire weight on the pcbconnection. Those 
using the QLas purchased should have no 
trouble fitting the unit as the edge connec- 
tor is at the correct height, provided the 
QL remains flat without its ridiculous plas- 
tic feet! As the manual stresses, the COV1 
should be raised to the QL’s level if a 
different typing angle is used. In my case, 
the temporary solution has been to remove 
the rom edge — connector socket from the 


rear casing and use it as a flying lead, 
sitting the CQV1 on the top of the computer 
casing, which conveniently brings the PAL 
input socket the front of the unit. A market 
obviously exists forsome enterprising soul 
to make a suitable jumper lead, because 
the convenience would be enhanced if the 
COQV1 wasn’t yetanother physical parasite 
of the QL motherboard. 

The manual describes the characteristics 
of the COV1, the installation of its hard 
and software, its use and, finally, gives 
application examples with basic program- 
ming and some sample prints of digitised 
pictures. Safety measures are covered 
sensibly during installation and any non- 
technical person should find the 
instructions easy to follow. Backing up the 
master software is also straightforward, 
but although it is capable of multi-tasking 
no assistance is given to those wishing to 
incorporate the boot program of exten- 
sion codes into a front-end, or a different 
program boot like Eye-Q, that you may 
wish to multitask it with. 


Sample display 


Having installed the extension codes and 
executed the main program, ‘IMAGED’, 
the screen quickly displays the program 
title and a sample of digitising above a 
command menu and status box. The com- 
mands are fully explained in the manual 
and are straightforward in their use as can 
be seen from the following list: 

F1 opens Menu window; F2 saves screen 
image in buffer to file; F3 loads screen 
image from storage medium; F4 samples 
video from input. This clears the screen of 
menu/status box but a flashing cursor 
remains in view at the bottom right of 
screen to signify that sampling is active; 
F5 clears screen; shift/F2 stores the last 
video sample in temporary buffer; shift / 
F3 recalls stores image from buffer to 
screen; control/F3 recalls buffer image 
and ‘ORs’ with screen image; control/ 
shift/F3 recalls buffer image and ‘XORs’ 
with screen image (Note: This command 
is not shown on the screen menu); D tog- 
gles between three display types (quarter 
screen (128 multiply 128 pixels), positioned 
on screen with cursor keys; four quarter 
screens, each being refreshed sequentially; 
full screen of 256 x 256 pixels); S toggles 
between video sampling modes, continu- 
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ous or keyed; N changes display to nega- 
tive image; I inverts displayed video; P 
prints the displayed image asa 1:1 dump. 

All commands except F2, F3 and P are 
usable during sampling without the screen 
menu being called up (F1) but this only 
became apparent on reading the full com- 
mand explanation for F4. 


Camera to monitor 


My first trial with the CQV1 was using a 
video camera set to monitor (in the same 
manner as you sometimes see in shop 
windows) which, with the controlling 
software running, gavea picture onscreen 
in the blink of an eye when a sample was 
taken using the space bar. Switching the 
mode to continuous gave the sampling 
iteration rate of 20 msec (data from manual) 
and toggling the display to quarter screen 
gave five frames per second, similar to an 
old handcranked movie! This partially 
substantiated the claim to monitor mov- 
ing pictures on one corner of the screen 
while editing text on another. Could this 
be the answer for computer-game-playing, 
security guards! 

Allaspects of the software and hardware 
ran smoothly and quickly but file in/out 


COGN 


commands do not allow for directory 
searches, so the absent-minded could be 
faced with the need to exit temporarily to 
SuperBasic. This in my opinion could have 
been easily remedied but is sometimes 
overlooked as unnecessary due to the QL’s 
multitasking capability. A saving grace is 
a warning given that a file already exists 
followed by the option to overwrite it. 

The black level adjustment allows the 
user to set the ‘blackness’ of the picture, 
giving control over the range of tones in 
the finished print. Theeffect can be equated 
to photographic print exposure: too much 
will be too dark, losing shadow detail, 
while too little will give a whitewashed 
effect in highlights. | found it easiest to 
determine the correct setting using quar- 
terscreen and continuous sampling where 
the time lag between pot adjustment and 
screen effect was minimal. The print com- 
mand is limited toa 1:1 dot matrix dump 
for Epson-compatible 9-pin printers, using 
codes ESC L and ESC]J to produce 120 dots 
per inch with an n/216 line feed. 


Device name 


The manual and menuare a trifle confus- 
ing when using the P print command. It 


Left: A course 

poster built up 

with digitised 
pictures. 
Below: a 
digitised print 
of the digitiser 
itself. 
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states that the device name for printing ‘is 
not limited to SER1H or SER2H, it could 
be any valid file name’. Does this mean 
that printer files can be spooled or does it 
mean that saved files can be printed. Ei- 
ther way I must be doing it incorrectly as 
I have been unable to use flp2_nnnn to 
spool or print saved files. At first [ had 
difficulty in printing files with the P com- 
mand from screen. The printer driver 
cannot be configured by the bundled soft- 
ware so if your printer is not 100% Epson 
compatible you should request assistance 
from CL Systems, who have shown will- 
ing when I approached them with my 
difficulty. They were very prompt in sort- 
ing out this problem, which entailed a 
small charge in the boot program. 

My printer is a Smith Corona D200 that 
works well with dot matrix dumps from 
Easel, Eye-Q, GraphicQL and DP Pro Pub- 
lisher, yet selecting P and entering SER1 
gives jumbled characters, printing only 
intermittently after recycling the printer 
driver file may require alteration in my 
case. The prints I have obtained are of 
good quality with a dense dot pattern 
giving a good range from white to black. 
Of course, some users are more likely to 
use other programs than dump direct from 
the COV1. Not however, that when sav- 
ing screens for later use in Eye-Q it is 
advisable to use the Negative function to 
invert the screen image prior to saving, as 
Eye-Q prints blackas white and vice versa. 

What users can the digitiser be put to? 
Your imagination will probably be the 
limit. The manual suggests slow frame 
recording (for biological growth?), gives 
a Basic listing and supplies the file to doit. 
Written for use with a 720 K disk, the 
program will store 21 full-screen images 
at time intervals set by the user. The given 
example can be altered to save only part 
screens thereby giving room for more 
screen on each disk. MDV users can also 
use the program withsome minor changes. 


From negatives 


One possible use not yet mentioned is to 
‘print’ direct from photographic negatives 
or positives. [ have experimented with 
colour slides, and both black and white 
and colour negatives with moderate suc- 
cess. Naturally the results are not as good 
as the real thing but you have another 
medium for gathering clip art of dtp pic- 
tures. 

I welcomed the COV1, especially for the 
numerous times I am asked to produce 
posters or to dtp for local clubs. Where 
one of my amateurish drawings took me 
several hours and pots of tea, I can now 
expect professional polish in a fraction of 
the time. My main difficulty, that it could 
have been more flexible if a jumper lead 
had been used to interface it to the rom 
socket, is one that will apply to only a few 
users. 
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FTWARE FILE 


O FLICK 


Flickis described in the 
instructions as.asmall 
user-friendly card in- 
dex database utility to 
handle simple database appli- 
cations, which seems a fair de- 
scription. Itis an alternative to 
Archive or FlashBack, for small 
jobs. [t does not have the pro- 
gramming language of Ar- 
chive, or the flexibility of 
FlashBack, but it is easy to 
use. Originally sold by 
Ultrasoft from Germany, 
the program has been taken 
over by Digital Precision; 
QL users who have bought 
programs from DP in the 
past will no doubt feel more 
confident buying from them, 
rather than from less-well- 
known companies. The ori- 
gins of the program are 
confirmed by its use of the 
QJump Pointer Environ- 
ment, which is included on 
the program disk. The 
Pointer Environment seems 
to have been taken up with 
more enthusiasm by pro- 
grammers in continental 
Europe than by those in the 
UK. Anyone familiar with 
Oram or Qpac will find the 
QFlick user interface es- 
sentially the same as with 
those program suites. 


Bryan Davies 
shuffles a 
new card 
index. 


The program is supplied on 
disk or cartridge. Apart from 
the use of the PE, the main 
features are thatitis completely 
written in machine code, is 
multi-tasking, has an on-screen 
help facility, and has dynamic 
memory allocation. It is re- 
entrant, and can be run as a 
Hotkey file, and data can be 
‘stuffed’ into the Hotkey buffer 
and transferred to another 
program, if you already havea 
QJump Hotkey function in- 
stalled. Either of the COPY or 
WCOPY commands can be 
used to make a backup copy. 
The program starts froma boot 
file; anyone who already loads 
the PE (or has it on rom) for 
other purposes should omit the 
boot to prevent a second load- 
ing of the PE files. QFlick itself 
can be started by the usual 
commands — eg EXEC, EX- 
ECUTE or EX - depending 
upon what SuperBasic exten- 
sions are loaded. Several cop- 
ies of OFlick can be run simul- 


taneously, and switched-be- 
tween by the CTRL-C keying. 
The standard QJump configu- 
ration routine is supplied, and 
allows the default database 
name, the default printer port 
designation (originally set to 
PAR in the review copy), and 
the field names (1-8), to be set. 

There are seven pages of in- 
structions, which are adequate 
for most purposes but could 
make certain points clearer. For 
example, it is not at first obvi- 
ous what the procedure for 
searching is: you have to select 
the data field which is to be 
searched, type the search string 
into that data field as though 
entering data into a record, 
press ENTER, and then select 
theSearch command. There are 
small inconsistencies in the 
stated maxima for field and 
data lengths; as entered 
through the configuration 
routine, the field length can be 
ten characters, but it can be no 
more than nine as modified by 
the LABEL command subse- 
quently. The data length can 
be 40 characters, as imported 
from an Archive EXP file via 
the conversion routine, but 
only 39 when entered directly 
into a data field in the main 
window. 


INFORMATION 


Program: QFlick Card Index 
System V1.04 
£29.95 (plus 5 or 
10% for overseas 
buyers) 

Digital Precision 
Ltd 

222 The Avenue 
Chingford 
London E4 9SE. 
Tel: (081) 527 
5493. 


The listing of key combina- 
tions for 'shortcut' ways of in- 
voking commands does not 
make it fully clear that the use 
of CTRL-SHIFT before the 
listed single keys will activate 
Modules and Commands op- 
tions directly, without the user 
having to go through the inter- 
mediate menus, but that this 
does not apply for a few of the 
options. The instructions say 
that running the Archive-to- 
OF lick file-conversion routine 
isas simple as using the LRUN 
or EXEC commands with one 
or other of the provided ver- 
sions of the Archnav file, but 
they omit to point out that this 
won't work if another program 
(eg QFlick) has been run pre- 
viously, because the RESPR 
command needed to load the 
Xtras extensions file can't work 
then (on a JM QL at least); you 
need to run the program on a 
‘clean' QL, or use ALCHP or 
equivalent command in place 
of RESPR. (The Updates file 
does correct the instructions in 
so far as pointing out that the 
EXEC command shouldn't be 
used initially). None of these 
points should cause significant 
trouble for experienced users, 
and the instructions are other- 
wise satisfactory. 

My current system disk in- 
cludes several Super Basic ex- 
tensions files, Q Switch, Text, 
FlashBack SE, Files 2 and Per- 
fection, and does not therefore 
provide a good environment 
into which to load QFlick. It 
could be loaded and run after 
the system disk had been 
loaded, but there were some 
problems with programs dis- 
appearing, and it is preferable 
not to mix Pointer Environ- 


Price: 


Supplier: 
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ment-based programs with 
others loaded ‘outside’ the PE. 
The ARCHNAV routine pro- 
vided toconvert Archive EXP 
files to OF lick format, or OFlick 
_DB files to _DBF format, did 
not seem to be able to multi- 
task with the other jobs, despite 
being EXEC-ed and having a 
cursor. Itjust beeped when any 
attempt was made to get out of 
it. The QFlick program file is 
15KB in size, and it (and the 
required extensions) took 
111KB when running; loading 
an 88KB database raised the 
total space used to 207KB. 


Pointer 


The main program window 
is shown in the first illustra- 
tion. The diamond-shaped 
pointer can be moved by the 
cursor keys ora suitable mouse 
(presumably, the Qimi one). As 
with other PE applications, the 
shape of the cursor changes 
with the area of the window it 
is over; for instance, a padlock 
shape indicates that the cursor 
has been moved outside the 
usable area. Movement of the 
cursors is very smooth, The 
QJump conventions for use of 
the cursor/pointer are fol- 
lowed, and there isa fairly wide 
range of them, which needs a 
bit of study if you want to 
streamline your use of the pro- 
gram. There are several ways 
to perform most functions. 
Data is entered into a record by 
either: 

1) moving the cursor (by cursor 
keys or mouse) to the field data 
area, so that a box appears 
around it, pressing the Space 
Bar, typing-in the data, then 
pressing ENTER, or 

2) selecting the data area by 
means of the 1-8 keys when in 
the main window, typing in 
the data, and pressing ENTER. 

To have a new record actu- 
ally inserted into the database, 
you use the INSERT command: 
1) cursor to Modules, Space Bar, 
cursor to INSERT and Space 
Bar or just press I, or 
2) simply press CTRL-SHIFT- 
I 


Selection of commands is 
similar: 
1) Move the cursor to the 
Modules or Commands panel 
(as appropriate), so that a box 
is displayed around the panel, 
press the Space Bar or left 
mouse button, cursor to the 
required command and press 
the Space bar or just press the 


appropriate letter for the com- 
mand. Itis unfortunate that the 
standard convention of high- 
lighting the letter of a com- 
mand ona menu, to select that 
command, is not followed; un- 
fortunately, it would not be 
possible to do this with some 
of the chosen letters anyway — 
eg the letter is V for LABEL. 
2) press f2 (for the Modules 
menu) or £3 (Commands 
menu), cursor to the required 
command. For example, CTRL- 
SHIFT-L will load the default 
database. Most of the letters 
used are mnemonics (as with 
the L for Load), but some are 
not (eg Y for Clear Display). 
Which method you choose 
depends to some extent on 
whether or not you have a 
mouse in the system; it may 
also depend upon how good 
your memory is for key com- 
binations, but the key shortcuts 
are undoubtedly the fastest 
way. The ways of selecting 
functions may cause some 
confusion at first, but there 
should be no difficulty once a 
particular method of operation 
has been chosen and the re- 
quired keypresses or mouse 
movements memorised. 

The Information panel gives 
the version numbers of OFlick, 
the Qptr interface, the Qman 
windows, and Qdos. The 
Control panel has small win- 
dows for Help, Modules and 
Commands. A sample Help 
window is shown in the sec- 
ond illustration; other pages of 
help can be obtained via the 
NEXT and BACK commands, 
from the Help window itself. 
The Modules panel allows ac- 
cess to the commands relating 
to individual records in the 
current database, as shown in 
the third illustration. The 
Commands panel gives access 
to commands which are con- 
cerned with the current data- 
base file as a whole (fourth il- 
lustration). You need to bea bit 
careful when 'backing up' from 
one menu level to another, be- 
cause what might seem like the 
obvious key for doing this - 
ESC — will kill the program if 
pressed when only the main 
window is displayed, whereas 
it does move you back to the 
previous menu if used from 
the Modules or Commands 
menu. The function of the Sta- 
tus panel is fairly self-evident; 
the ‘running jobs' figure will be 
the total of all jobs running in 
the OL at the time, as is also 
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recorded by the SuperBasic 
Jobs command. The free 
memory figurecan go negative 
— if you get no response from 
the Help, Modules or Com- 
mands panels, have a look at 
this figure. 

The important panel for data 
entry and manipulation is the 
area ‘Records’. There are eight 
slots here, for field data. To the 
left of each slotisa space for the 
name of that field. You can't 
get into the field name areas 
using the cursor— you have to 
go via the Commands menu 
and the Label command. A 
maximum of 10 characters can 
be used for field names; there 
is no requirement for the $ 
symbol (a feature of Archive) 
to be used. 


Conversion 


Users will wish to be able to 
make use of existing Archive 
database files, and that is pos- 
sible, The supplied Archnav 
conversion routine is a bit 
sparse — eg it takes no account 
of available space when start- 
ing on a conversion, and just 
dies if it runs out of space to 
store the converted file — but it 
does the job. It would normally 
be used only occasionally, 
perhaps just when files are 
transferred initially from Ar- 
chive to QFlick. The fields and 
their names from the Archive 
file are put into a _DB file, 
within the restrictions imposed 
by the latter's structure; field 
names can be up to 10 charac- 
ters in length, and datain fields 
will be truncated if it exceeds 
40 characters in length. The 
field names can subsequently 
be changed from their Archive 
form to whatever is chosen in 
OF lick by using the Label com- 
mand; there is no requirement 
to have the $ ending. The RU 
command of any version of The 
Editor can be used to load _DB 
files, or the Archnav-converted 
versions (for transfer to Psion 
programs), for editing. 

The 267-record file contain- 
ing the record on display in the 
main window (firstillustration) 
was created by the Archnav 
routine from an Archive name 
and address file, in a few sec- 
onds. The original Archive 
_DBF file was 25KB, the EXP 
file 21KB, and the converted, 
_DB, file 88KB. A couple of 
attempts to convert the result- 
ing _DB file back toan Archive 
_EXP file appeared to be suc- 


cessful, but Archive would not 
Import the resulting files. A 
quick check of the file structure 
didn't reveal anything obvi- 
ously wrong. There is another 
conversion routine, supplied 
for users of version 1.00 of the 
program, to make their data- 
base files suitable for use in 
1.03 (and, presumably, the 
supplied 1.04 too), although 
this is not mentioned in the 
instructions. 

The program works smoothly 
and reasonably quickly, with 
no untoward behaviour. A 
mouse is a highly desirable 
accessory when using any 
program which is ‘fronted’ by 
the Pointer Environment, At 
first try, the new user might 
well find this program rather 
cumbersome in operation, as 
using the cursor keys to move 
the mouse pointer emphasises 
the rather pedantic nature of 
this aspect of the interface, with 
lots of key action being needed 
to accomplish most tasks. 
However, careful study of the 
instructions, and some experi- 
mentation, will show that the 
provided keyboard shortcuts 
allow you to bypass most of 
the keyboard actions. The 
program then becomes very 
much pleasanter to use. Hark- 
ing back to comments made in 
the review of another database 
program not too long ago, it is 
important to allow for the 
knowledge level of the major- 
ity of likely buyers when writ- 
ing the instructions, and this 
seems particularly important 
when the Pointer Interface 
fronts the actual application 
program. Fortunately, Digital 
Precision have realised thisand 
provided instructions which 
give sufficient guidance to al- 
low the most to be got from the 
database facilities. No confir- 
mation request is issued before 
a Load or Save is carried out, 
and this could cause trouble if 
you have omitted to make a 
desired change to the file or 
device name in the Load /Save 
slot on the main program win- 
dow. Similarly, the Delete 
record function does not re- 
quest confirmation. While 
omitting a confirmation re- 
quest streamlines operation, it 
is perhaps safer to have one, 
for most users. 

This is not one of DP's major 
epics, but it is a capable pro- 
gram, at a moderate price, and 
particularly-suited to use un- 
der the Pointer Environment. 


SOME THOUGHTS ON 


DISK STORAGE 


As alternatives appear, Bryan Davies reconsiders 
his approach to mass storage. 


ack in 1990, most of us were still 

managing to store our mass of 

files on cartridges or floppies, 

but some were getting increas- 
ingly frustrated by the lack of space on 
single media. Cartridges had always been 
too expensive and unreliable. Some com- 
puters still used 360 KB floppy disks as the 
basic storage medium, so we were not the 
worst-off; our 720 KB disks stored a rea- 
sonable amount of the program. If you 
were in the habit of loading several pro- 
grams, and switching between them 
though, 720 KB was a pretty small pot to 
get all the required system files into. The 
question was, was it worth spending over 
£400 for a hard disk? 


Lots of money 


That was, and is, alot of money for most 
of us, and relatively little was known about 
hard disk on the QL, making it rather a 
blind decision to make. Those of us who 
had experience of hard disks on other 
computers were at least familiar with some 
of the advantages and problems. The de- 
cision was made easier for me by the 
arrival of a Miracle hard disk unit on my 
workbench, brought to me by the proud 
new owner, with the instructions to ‘set it 
up’. | could find out the cheap way what 
hard disk on the QL was like. 

There was an obvious interest in hard 
disk within the QL community, and the 
setting-up process would generate enough 
material for an article. That article sits 
before me on the screen now; after a 
struggle, it got completed, but somehow 
never got into printer at the time. Looking 
at it now, it is rather ridiculous to read. 

So what changed? One user's require- 
ments are not identical with those of an- 
other, but there are almost certain to be 
common items on the ‘wants’ list of most 
new hard disk owners. High on the list is 
the ability to put files into separate com- 
partments, in order to be able to identify 
particular groups from amongst what may 
amount to thousands. A sub-directory 
structure is needed, and the Miracle hard 
disk is not well-provided in this area. There 


is a sub-directory structure, but it is short 
on commands and hard to deal with, and 
it does not allow convenient running of 
several programs from their own sub- 
directories. 

In a sense, my wheel has turned full 
circle. The article on hard disk arrived 
back for updating at the same time as | 
decided to remove from my friend’s hard 
disk the sub-directories already created. 
That is, I'd decided he was going to have 
to use the 40 MB storage space like one 
enormous floppy disk, with all the files 
going into the root directory. No doubt 
some other hard disk users have been 
doing that all along. 

That isn’t the end of the story, however. 
There has been a new development re- 
cently. Miracle have come out with what 
looks like a major boost for the QL, in the 
form of the Gold Card. That in itself will 
add new life to the QL scene, by allowing 
existing programs to run much faster, and 
thereby rekindling the interest of users 
who are fed up with the snail-like progress 
of work done on Quill and its associates. 
More to the point in the present context, 
the Gold Card comes complete with the 
ability to handle high-density 31/2in disk 
drives, giving the possibility of storing 
1.44 MB on each disk. Even better, there 
is the prospect of 3.2 MB drives being 
available for the Gold Card in the not-too- 
distant future. Maybe it is time to rethink 
what we really need, to get around our 
storage problems? 


Boots growing 


The initial reason for my getting itchy 
about lack of storage space was not the 
need for masses of floppies to keep files 
on, but the fact that my boot system files 
were growing in number and size and 
could not comfortably be held on one 
disk. Each time a program revision ar- 
rived, there would be a time-wasting 
session, trying to delete yet another file to 
allow for the (inevitable) extra space the 
revised version took compared to its 
predecessor. 

Quite simply, the one, vital disk in my 


collection was no longer coping with the 
strain. Incidentally, it really is one disk, as | 
stilluse the actual disk bought from Eidersoft 
way back in 1985 and set up as a boot disk; 
it is numbered eight in a collection now 
running to several hundred and must have 
done many, many miles. 

That's one reason for wanting a larger 
disk. Undoubtedly, some other users will 
be much more concerned about the in- 
creasing space taken by their disk collec- 
tion, as the number of files increases over- 
all. These users may not even load more 
than one program at any given time; there 
will surely still be some who run only Quill 
most of the time but, nevertheless, create 
many document files. Disks and their 
boxes take up much space, and cost a lot 
of money. Careful buying at computer 
fairs can keep the costs in check, but 
cannot do anything about the space prob- 
lem. 

There is also the retrieval problem. Un- 
less you keep detailed and up-to-date 
records of what is on each disk, you find 
yourself having to check directories of 
several disks to find the file you want. This 
situation arose for me quite early on; within 
a few months of buying my first QL in 
1984, in fact. All my work was done with 
Quill, and there were plenty of individual 
documents and quite a few very large 
ones. One of the documents created in 
microdrive days ran to 288 KB when as- 
sembled (later) onto disk, from about 25 
separate files. Of course, many of those 
documents are long gone, because they 
could not survive the dubious storage 
capability of cartridges; they were de- 
stroyed by the system, in other words. 


No leap 


Disk drives became readily available, ata 
reasonable price, about a year after the QL 
entered my life. The storage problem was 
ended, overnight. Not only was there a lot 
more space on each disk, but the files were 
actually still usable months or years later. 
No more ‘bad or changed medium’ mes- 
sages (well, very few anyway). Things were 
quite good for a year or so, but the situation 
deteriorated once again. This time, there 
was no answer for the QL; the number of 
files was into the hundreds, but there was 
no ‘quantum leap’ in storage method avail- 
able. For this, and purely commercial rea- 
sons, a PC with hard disk took its place 
alongside the QL. There was just no way 
the QL could cope sensibly with 50-100 MB 
of files, then or now. Leastways, that was 
the way it looked until the Miracle hard disk 
arrived on the scene. But I've already said 
that this doesn't really provide what | need, | 
because | want files and programs in 
separate areas. Could the new high-den- | 
sity disk drives, possibly with hard disk too, 
provide a viable solution? 

Accepting the impracticability of running 
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several programs from separate hard disk 
sub-directories, there is still the option to 
use high-density floppies for system files, 
and the hard disk for data files. As data 
files can be identified fairly easily by their 
extensions — DOC, _T87, ABA etc — there 
is less of a problem finding particular ones 
when they are allin the root directory of the 
hard disk. 

Given some serious thought and work, it 
would be possible to set up a relatively 
simple sub-directory structure, for data 
files only, and use it with those programs 
that can cope with device names longer 
than about five characters. Hopefully, some 
kind programmer will eventually produce a 
decent, cheap utility program to permit 
simple and rapid housekeeping opera- 
tions in a sub-directory environment. Disk 
operations should not be slow with the 
Gold Card; it is claimed that floppy op- 
erations will be at a comparable speed to 
harddisk ones onthe basic QL. As program 
loading may take less time overall than the 
loading and saving of data files, continuing 
to load programs from floppies may not be 
a serious drawback. 


More floppies 


There is an additional operational factor 
to consider. A hard disk does not make 
copies unnecessary; you still need backup 
copies. With the growing collection of data 
files on your hard disk, you can be in queer 
street if any access difficulty occurs, and 
that is not an uncommon occurrence with 
hard disk. A backup set of files must be 
kept on floppies. This brings up an unsat- 
isfactory area even on a computer with 50 
MB or more of hard disk storage space; 
making backups to 720 KB floppies can 
soon get you used to ‘no room at the inn’ 
messages. 1.44 MB floppies ease this 
situation considerably, but not for ever. Itis 
good to be able to contemplate the next 
step mentioned in the Miracle literature — 
to 3.2 MB—in advance of the need for it. At 
the moment, I'm not aware of 3.2 MB 
drives being offered for PCs in this coun- 
try, So we may be one-up on the PC world 
there (but these drives are standard on 
some computers sold in the Far East). For 
the record, there are floppy drives which 
give as much as 25 MB capacity per disk, 
with a quoted price of about $30 per disk 
(£15 or so) butif'll be quite a while before such 
capabilities become readily available. 

It may be that some readers will not be 
familiar with 1.44 MB drives, let alone 3.2 
MB ones, so a few details are appropriate 
at this point. Physically, 31/sin 1.44 MB 
drives look just like your existing 720 KB 
ones. There's no difficulty installing them. 
The disks themselves look essentially the 
same. The one difference you may notice 
on HD disks is that there is a matching 
square cutout on the opposite corner of 
the disk from the write-protect slide. This 
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extra cutout is used by some drive mecha- 
nisms to detect a HD disk. While a stand- 
ard 720 KB drive will not read 1.44 MB 
disks, a 1.44 drive will read and write both 
1.44 MB and 720 KB disks. 

In the case of the drives being offered by 
Miracle, it looks as though the driver soft- 
ware, rather than the drive mechanism 
itself, detects what the capacity of an in- 
serted disk is. This allows the user to 
format DD (720 KB) disks to 1.44 MB and 
use them in the HD drives. It remains to be 
seen whether or not this practice is satis- 
factory on the QL, but it works on some 
PGs. 

The identifying cutout is not made for 
nothing — some drives will not format disks 
to 1.44 MB unless they have this cutout — 
but it looks as though we don't have to 
bother too much about it. 

Quoted capacities can be a bit mislead- 
ing, because both unformatted and for- 
matted figures can be given, and different 
operating systems produce different for- 
matted capacities. Our standard 720 KB 
formatted-capacity disks can be referred 
tobe as 1 MB unformatted capacity, or 800 
KB formatted on some computers. For our 
purposes, the actual usable storage space 
is 717 KB, because there is asmall amount 
of information put onto the disk at format 
time for the benefit of Qdos. The normal 
1.44 MB formatted-capacity disks are 
sometimes referred to as being of 2 MB 
unformatted capacity. (Likewise, 51/4" high- 
density disks can be called 1.6 MB 
unformatted or 1.2 MB formatted). 

Just what the available space for QL 
users will be, | don’t know, but presumably 
something over 1.42 MB. The sector size 
should still be the same, at 512 bytes, so 
that a format will show 2,880 sectors (1.44 
x 1000 x 1024/512). 


Backups 


The much-greater capacity of hard disk 
soon brings you face to face with a major 
problem; backing up files. If you don’t do 
that regularly, you are either a bit daft (to 
put it mildly) or are not doing anything 
important enough to justify hard disk any- 
way. My own time-scale for backing-up 
word-processing files (like this article) is 
every 5-10 minutes, the larger figure only 
being used on very large files, when more- 
frequent backing-up would begin to inter- 
fere with the input of words. When the data you 
enter is already on paper, you are ina position 
to retype it without straining the grey matter; all 
you lose is time and temper. Should the 
material be ‘off the top of your head’ (maybe 
you write novels?), the idea might not be 
recaptured if retyping becomes necessary 
through loss of the original file. Losing 720 KB 
from a floppy can be a pain, but not anywhere 
near as much of one as losing 40 MB from 
hard disk. 

Whatis needed is a means of backing up 
large quantities of files, quickly, onto small 
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quantities of floppy disks. Not surprisingly, 
that facility was not included with the hard 
disk software; such things are normally left 
to software houses to provide. One soft- 
ware supplier did advertise a program for 
the job — HardBack — but the supplier was 
PDQL, and we ail (I hope) know by now 
that this has not proved the best source to 
get software from these days. The pro- 
gram should be good, being written by 
Chas Dillon, but it is an open question 
whether or not it will become available 
from other suppliers in the future. 

Dilwyn Jones Computing has introduced 
the program WinBack, which should pro- 
vide essentially the same facility as 
HardBack. In its initial version, WinBack 
does not permit backup files to be split 
between floppy disks, that is, if the next file 
to be backed-up is larger than the remain- 
ing space on the current backup disk, 
another disk has to be inserted. This can 
create a lot of wasted disk space, if files 
tend to be large. A later version of the 
program should allow the splitting of files, 
to avoid the ‘waste’ of disks. 

Storage space appears again on my list 
of reasons for buying the hard disk, but this 
time in a somewhat different context — use 
of the PC Conqueror emulator, to run MS- 
DOS programs. One thing current MS- 
DOS programs aren't is slim and trim; put-|. 
simply, some of them are grossly over- 
weight. A PC with only floppy drives is 
close to being unusable in practice, be- 
cause major programs do not fit onto one 
disk and you are forever swapping disks. 
On old PCs, which were slow anyway 
(even with hard disk, in some cases), 
being distracted by demands to swap disks 
can be enough to completely put you off 
whatever work you are trying to do. Al- 
though any emulator is likely to run slowly 
compared to whatitis emulating, aQL with 
Conqueror and a hard disk may be a better 
bet than an old PC with floppies. You may 
well not use more than 5-10 MB of the hard 
disk for Qdos files, so giving (say) 10-15 
MB to Conqueror for MS-DOS should 
present no problem to most users. Of 
course, with the Gold Card, it should even 
be acceptably speedy for regular use. . . 

The hard disk sub-system makes use of 
about 55 KB of QL ram memory, making it 
quite pointless to consider adding a hard 
disk to a system which is not fitted with 
expansion memory. 128 KB less 32 KB for 
the display and 55 KB for the hard disk 
leaves little memory for running programs. 
If you use /ce or Files 2, or some similar 
housekeeping program, you would end up 
with maybe 20 KB to run an application 
program in Quill for one would soon tell 
you what to do with that measly allowance 
. .. The hard disk and Gold Card are 
compatible, as are hard disk and Trump 
Card. Going either the hard disk or the 
Gold Card route leaves the rom port free 
forwhatever programs you have on Eprom, 
whether it be Ice or a collection of utilities 
(maybe program-development tools) 
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specially blown onto Eprom. 

The Gold Card projects only a small 
amount from the QL, whereas the Trump 
Card extends the length considerably; 
there is a big difference in the space taken 
by a system with Trump Card and hard 
disk, compared to one with just the Gold 
Card (assuming both systems would have 
the same number of floppy drives). In the 
hard disk’s favour, there is no obvious 
reason why the size of the drive unit 
should not be increased, possibly with the 
existing interfaces. Don’t take my word for 
that, though;checkwith Miracle before starting 
on an upgrade. The drive inside the Miracle 
box is almost certainly ‘PC-compatible’. 

The well-heeled user may opt to make 
Miracle happy by buying hard disk, Gold 
Card, andhigh-density floppy drives. The 
rest of us, being budget-conscious, have 
to make a decision. The reason for buying 
the hard disk is, primarily, the desire to 
have large numbers of files quickly and 
easily accessible at any time. In a word, 
convenience. 

The floppy drive is reliable, and hard 
disk should not be bought to combat reli- 
ability problems; if your floppy drive is 
unreliable, the chances are you are not 
treating it properly. Try buying a disk head- 
cleaning kit, and using it regularly. The 
user who lets floppy drives get in bad 
shape may well cause hard drives to go 
the same way; it's not a question of 
cleaning here, but of general handling. 
Don't bang the drive box about, and don't 
move it unless the drive heads have been 
‘parked’ (this is done automatically with 
the Miracle drive, provided you don't switch 
off when the drive heads are still accessing 
data). 

A secondary reason for purchase may 
appear to be the need to save space but, 
if you take the business of backing up files 
seriously, you will realise that space for 
many floppy disks, and their boxes, is still 
required, although half the number of 
floppies means roughly half the amount of 
space. Unfortunately, hard disk box is so 
large that it take up the space of the 
equivalent amount of floppies and their 
box. 

You come back to speed of loading and 
saving, and the amount of instantly-avail- 
able storage space, as the main reasons 
for buying hard disk. In rough terms, the 
speedis around three times that of 720 KB 
floppy drives. If you buy the Gold Card and 
1.44 or 3.2 MB drives, the speed differen- 
tial may become less of a major consid- 
eration. That's a lot, but 50 floppies don’t 
cost too much (less than £20) and don’t 
take up that much space either. It isn’t 
hard to argue that improvements of this 
order are not worth the money. 

In addition, there is the not-inconsider- 
able matter of having to locate a hard disk 
unit very clase to the QL, because of the 
short connecting cable supplied. There are 
presumably good technical reasons for 
the short cable, and it doesn’t seem a good 
idea to try and substitute a longer one. My 
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own solution to the location problem was 
to turn the hard drive unit upside down and 
sit the QL on top of it; this enabled me to 
get away with no major revision to the 
system layout (which there’s no space 
for), but it does preclude the use of arom 
cartridge such as Ice, because the port is 
covered by the workbench. 

Files 2 has proved an adequate replace- 
ment for Ice, so that drawback doesn’t 
bother me unduly. The elevated position 
of the keyboard is rather hard to get on 
with, and — in the long term would be 
solved by mounting the hard disk under 
the workbench, with a cutout for the con- 
necting ribbon cable. What is of much 
more concern is the noise, which is suffi- 
cient to take precedence over my noisy 
PC and laser printer, but current produc- 
tion units do not have a fan installed and 
the noise of the drive itself should not be 
too much of a distraction. 

Youcan'tgenerally buy software already 
installed on hard disk (the Next computer 
comes loaded with software, but it is an 
exception}, and floppies are still the al- 
most universal medium for distributing 
software. The very features which make 
the hard drive such a boon are also a 
considerable nuisance. Its sealed con- 
struction, and ‘hidden’ location within the 
bowels of a computer or add-on box, 
make it something that can be — to a fair 
extent — used and forgotten. These fea- 
tures also mean that you have to be able 
to trust it, for there is no simple changing 
of a cheap, push-in disk when error mes- 
sages are seen on the screen. Whichever 
way you look atit, you are likely to be using 
floppies for the forseeable future. 


Convenience 


There needs to be more than the speed 
and extra storage to convince me of the 
viability of hard disk, and its convenience 
that provides it. A computer system really 
ought to help the user, and enable him/her 
to concentrate on the job in hand, rather 
than having to fiddle about with disks, 
making sure they are formatted and have 
sufficient space. In this respect, the hard 
disk shines. QL users are well-favoured 
compared to users of some other comput- 
ers, as the 40 MB capacity provided by the 
Miracle unit is large for a ‘small’ computer. 
You can go on saving and adding files for 
a long time before a clear-out session 
becomes necessary, and regular saving 
of files is much less of a chore. 

If asked to instance just one advantage 
my PC/AT has over the QL without hard 
disk, my answer would certainly be that 
Save times are very much shorter. Proc- 
essor speed advantages may look great 
in adverts, but that’s not what it's:all about 
for most of us; we don’t do much that 
demands fast processing, butwe do make 
plenty of use of files on disk, and that’s 
where time needs to be saved. 

That might seem to be that, the overall 


convenience of hard disk outweighing all 
other considerations. Fora similar outlay, 
can the Gold Card plus high-density drives 
offer as much, or more? Not yet having 
had the chance to see what the speed 
improvement is in normal use, | have to 
reserve judgement, to some extent, but | 
don't doubt that QL computing will be 
generally much more pleasant at the higher 
cpu speed. Even Quill should become 
acceptable nippy (but its bugs won't go 
away). The normal increase in speed is 
quoted as anything from x3 to x5. It takes 
a change of about 25% for an average 
person to be sure there is a difference, so 
the improvement with the Gold Card should 
be clearly evident. 


Gold Card 


Up to this point, no mention has been 
made of that other storage area, the ram, 
but the Gold Card brings with it about 2MB 


of that, to raise the practical maximum to } 
more than twice that with a Trump Card. | 


Now thatis a feature well worth having, for 
those of us who want several programs 


loaded concurrently. At present, 896 KBis | 


restrictive for me, both when reviewing 
programs and when doing other work. You 
can’t have two major programs say, text” or 
Perfection, and Archivewith alarge database 
in use plus a utility such as Files 2and a pop- 
up like FlashBack SE loaded, and then load 
another large application. 

Don’t tell me nobody tries to do this, 
because I'm sure it’s not only me that 
wants this many programs available, in- 
stantly oncall. To have 2 MB of ram, and 
have whatever is in it running at several 
times the speed it does with the Trump 
Card, is a very attractive prospect. What 
else? Well, there is a built in battery- 
backed clock. Not a major thing, but one 
does get used to having the time there 
automatically, without having to be set, 
and I'd much rather have this feature built- 
into the main expansion board than ona 
piggy-back board inside the QL. For most 
of my currentpurposes, the 1.44 MBdrives 
would suffice; the potential to go to 3.2 MB 
gives some elbow-room beyond that. 

With the proviso that we don’t yet know 
how well the Gold Card and high-density 
drives will: operate in long-term service, | 
think my choice would be to go for that 
combination, rather than for the hard disk. 
This conclusion dees:surprise me some- 
what. With the PC/AT, my feeling has 
always been that hard disk first, and extra 
ram second, have been the priorities, with 
a faster processor scarcely being consid- 
ered, but that was a faster machine to start 
with than the QL. The QL needs the extra 
speed, not really because 8-bit, 7.5 MHz 
wait-state operation is rather slow, but 
because many of our favourite programs 
were not written to give optimal speed. 
Compare FlashBack and Perfection with 
the Psion Quartet and you'll see what a 
difference smart programming can make. 
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C= eee 


JUST FOR STARTERS 


J 100 open#1,scr_509x200a2x1: ink#1,7: paper#1,2: ink#0, , | 


110 open#2,scr_ §09x200a2x1: ink#2,2: paper#2,7: 
open#4,sert: baud 9600 


Listing one 


presents a Fe ; : 

' efproc menu 
setof ‘DIY | 150 cls: print\\\to 36;'MENU'\\to 10;'A'to 15; 'Load data’ 
instructions to 50;'B'to 55;'Save data’ 


for program- 160 print\to 10;'C'to 15;'Enter data'to 50;'D'to 55; ‘Amend' 
170 print\to 10;'E'to 15;'To screen'to 50;'F'to 55;'To printer' 


ms 180 print\to 10;'G'to 15;'Print program'to 50;'H'to 55; 
SuperBasic. 'Save program' 
. _ 190 print\to 10;'I'to 15;'Stop' 
Using a da 200 i=code(inkey#(-1 }js cls 
tabase as an 210 sel on i 
exmple, he 220 =97: Tod: =98: sav 
. 230 =6=99: records: =100: alter 
builds up a 240 ==101: scren: =102: prin 
set of rou- 250 =103: listprog: =104: newprog 
270 end sel 
280 enddef aa 
here must be many Listing two} 
new QL owners who Boned 
would enjoy writing, 
their own programs, 290 =: 
tailored to their own specific 300 rem------ LOAD DATA---------- 


needs, if they knew where to 310 defproc lod 


start. mustconfessthatIhave | 399 c¢is#0: at 3,10: print'How many entries this sitting?’: 


never bought any software, ; 
haven't a ie ak ie compil- input#0 ’ ‘Number ' to 10;max 


ers, assemblers, etc. and don’t 330 at 3,60: pri nt max : ; 
use boot files or the Psion 340 at 5,10: print'Are there any previous entries? (1/0)': 
quartet. Despite this, the QL prev=inkey$(-1 ) 
runs my business, prints in- | 350 at 5,60: if prev: print'Add to file‘: else: print'New 
voices, order forms, stocktak- file’ 
re eee arco” | 360 at 7,10: print'Name of file’: cls#0: input#0;‘Name'to 10; 
‘ ak file$ 
bases for my hobbies. ; ; 
This article serves the same 370 at 7,60: print file$ 
purpose as do the instructions 380 at 12,25: print'Is this correct? (1/0)': correct=inkey$(-1) 
with a DIY car kit. When com- 390 cls#0: if not correct: cls: lod 
pleted, the menu will enablea 400 if prev then 
number of simple operations 410 open in#3 ."mdv1 "SFfiles$ 
ie a z= : Ps : . ~~ . 
men neieee coos pening 420  input#3,previous: max=max+previous 
cing a program, ee Peo” | 430 dim item$(max 30) »num(inax) 
grammer must be able to de- ae nu aX ; 
fine the basic requirement and 440 for x=1 to previous: input#3 ,item$(x) snum(x ) 
then enumerate the sections 450 close#3: num(0)=previous 
that will fulfil that requirement. 460 else 
470 dim item$(max ,30) ,num(max) 
Database 480 endif 


I have chosen a database as a 490 menu 
useful example simply because 900 enddef 
it contains procedures that can 


Listing three 
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be used in other operations, 

The basic requirement of a da- 5 

tabase is to manipulate data, ENTER DATA 
which might consist of books, defproc records 


addresses, workshop tools or . batches Z ‘ 
music tapes. In order to keep if prev: x=num(0): seeline 


this introductory article as for x=num(0 )+1 to max 

simpleas possible, a bare mini- cls#0: print#0,'Name(just ENTER to exit)'\fill $('-' 30): 
mum of processes are consid- input#0 ,nam$ 

ered: 1, allocate ram space = 18s 

(load /re-load), 2, enter due 3: ‘ ls cae tx 

store data 4. print to screen 5. H ; ( . 
save program. Sorting, ab- input#0,'Number'to 10;num(x): seeline 
stracting and printing the pro- num( 0 ) =X 

gram or data are dealt with endfor x 

later. 

First, the screen format is ad- 
justed for ease of use, The de- 
fault setting when switched on 
splits the Saens in two, with SEE A LINE 
#(channel)2 on the left and #1 defproc seeline 
on the right. I use a full screen print x,num(x) ,item$(x) 
for both channels, never find- enddef 
ing the need for special win- Listing four 
dows. 50 the program com- 
mences with the lines in Listing 
one. 


Colours SAVE DATA 


With a green monochrome defproc sav : 
monitor, this makes program delete "mdv1_"&file$ 
lines green on a black back- open_new#3,"mdv1_"&file$: print#3,num(0) 


ground and program output = . ; ‘ 
the reverse. The ink#0 in line eB to num(0) 7 print#3 I tem$(x )\num( x) 


100 makes editing brighter. If 


your printer has a parallel in- delete "mdv2_"&file$ 


terface, alter ser to par. If you copy "mdvi_"&file$ to "mdv2_"&file$ 
have a colour monitor, choose menu 
your preferred colours. To en- enddef 
ter these two lines proceed as 
follows: 
Type auto and press ENTER. 
A 100 appears below, so don’t 800 : ; 
type the line number, but type i 
everything else exactly as 810 SCREEN SHOW 
shown - no capitals. Press 820 defproc scren 
ENTER and see what appears. = 
Clever QL! From this chit on, a jade Pi num(0) 
always press ENTER after an 850 if x/20=int(x/20) th 
instruction to type something =INt (Xx en 
in inverted commas. 110 will | 860 cls#0: print#0,'Press any key to continue or ESC - back 
now have appeared below, so to menu': c=code{inkey$(-1)) 
ca the second lineand EN- | 870 if c=27: menu: else: cls 
TER. Now follow these steps: 880 endif 
(1) Hold down CTRL and 
presstheSPACEbar.Youhave | 890 endfor x ; 
now left auto. (2) Type ‘run’ | 900 cls#0: print#0,to 30;'Press any key for MENU': pause 
(but not the inverted commas). 910 
(3) Type ‘cls’ (4) Type ‘list’. Your 920 
two lines now reappear. Don't 930 
worry about part of the screen 
staying dark it will soon clear. 940 SAVE PROGRAM 
If it offends, type ‘cls#2’ then | 950 defproc newprog 
type ‘list’ again. 960 delete mdv1i_database 
From now on, allsubsections | 970 save mdvi_database 


will be self contained 
PROCedures operated by a | 980 delete mdv2_database 


menu which is itself a | 990 copy mdvi_database to mdv2_database 


PROCedure. This is listed be- | 1000 menu 
low butis not operationaluntil | 1010 enddef 
you have written the remain- 
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JUST FOR STARTERS 


ing PROCedures. To continue 
writing the program, type ‘auto 
120’ and copy Listing two inthe 
same way. 


Ascii 


Each character on the key- 
board has an Asciicodenumber 


| (see the User guide, Concepts, 


p.59), a=97, b=98 etc. Though 
capitals are printed inthemenu, 
this is just a guide to which key 
to press, which will always be 
lower case. In line 200, inkey$ 
waits for ever until a key press. 
Code reads the code number 
and transfers it to the variablei. 
This could just as easily have 
been q,z or bottle! SELect checks 
the value of i and chooses the 
correct PROCedure. From now 
on all PROCedures will be 
separated by a colon and 
headed with a REM statement. 

The QL keeps a tally of all 


| PROCedurenames and accepts 


the name as a user command to 
execute that PROCedure. You 
could type it from the keyboard 
with the same effect. Line 260 
however, incorporates an ex- 
clusive QL rom command 
which means ‘stop everything 
and take a coffee break’. The 
backslash (\) forces a new line, 
so three of them force three 
blank lines. The next 
PROCedure combines both 
loading and ram space alloca- 
tion and will inform the QL of 
your requirements —how many 
entries, whether commencing 
for the first time or additional 

} ones and the file name. When 
starting, make up a name such 
asaddress, toolorcard, etc. You 
can always check the filename 
if your list is mislaid by typing 
‘dir mdv1_’. Now type in List- 
ing three. 


Yes/no 


When the program is finished, 
but not yet, wherever 1/0 ap- 
pears, press either 1 for yes or 0 
for no. In line 360 you type the 
nameand press ENTER because 
it is an INPUT. Lines 340 and 
380 require a single keypress 
only, because that is all that 
inkey$ is waiting for. Notice 
how, in line 380, by choosing a 
suitable variable ‘correct’ in- 
stead of ‘x’, the next line reads 
understandably; otherwise one 
would have had to type ‘if not 
a’ or ‘if not x’, which means 
little to a beginner. 


The computer interprets the 
situation as follows: if a vari- 
able has a value of 0 (nought) it 
is considered FALSE while val- 
ues greater than zero.are con- 
sidered TRUE. Line 390 is 
therefore really stating ‘if not 
TRUE’ (ie if not having a value 
greater than zero) then clear 
screen and start again. By 
pressing 1, the variable ‘correct’ 
has a TRUE value and so the 
final two commands at the end 
of the line are ignored and 
processing continues toline400. 
Here again, is ‘prev’ true or 
false? If false, then line 460 on- 
wards gives alternative com- 
mands. Dim stands for 
DIMension, the size of the data 
space required. 

Now type in Listing four. 


Previous 


If there were some previous 
entries, ‘prev’ will betrue (from 
line 340), so at 540 your last 
entry can be shown because 
num (0) held your total previ- 
ous entries — line 600. By encap- 
sulating line 670 in a separate 
PROCedure, it only needs typ- 
ing once, even though it may be 
used a number of times. If this 
isanewentry, num(0) willequal 
zero automatically and since 
zero + 1 = 1, x will commence 
with a value of one. With 35 
previous entries, x would com- 
mence at data number 36. At 
560, fill$ prints out 30 dashes to 
make sure that your entry 
doesn’t exceed the size of the 
array you have set up. Now 
type in Listing five. 

When this program is com- 
pleted, but not until then, you 
will always commence by load- 
ing (A in the menu), whether 
there is anything to load or not, 
because this PROC is also used 
to dimension thearrays for data 
storage. You willtherefore have 
already given file$ a name and 
therefore lines 720 to 770 have 
all the information the QL 
needs. Lines 720 and 760 are 
there because the QL is uncon- 
cerned whether there is any- 
thing to delete or not, so just 
one PROCedure is required 
whether this is a new start or 
overwriting a previous block of 
data. It covers both options. The 
backslash in 740 is necessary to 
separate the two data items on 
the cartridge. The QL 
automaticaley addsa backslash 
of its own after the num(x) be- 
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fore the loop returns with the 
next values of x. 


Errors? 


If youarea keen student of the 
manual, you may think that 
there are some grammatical er- 
rors here and there. In line 740, 
the loop appears unfinished, 
with no ‘end for x’. This does 
work, providing that nothing 
else is added to the line. Again, 
when reading the manual, it 
does appear that all commands 
and even mathematical signs 
are separated from each other 
by a space and, in most in- 
stances, this is essential. Since I 
will never proceed to disks, I 
tend to be mean over cartridge 
space. In line 590 for example, 
the command ‘TO’ follows im- 
mediately after the inverted 
commas. Evidently the QL does 
not consider the (’) to be a spe- 
cific character but merely an 
identifier of characters which 
need printing to the screen and 
so it also acts as a space. How- 
ever, there must bea space after 
the ‘TO’. Also, despite a ten- 
dency to contract program lines, 
I always leave a space after 
every colon which separates one 
command from another, be- 
cause it makes the line more 
readable. 

Two short PROCedures com- 
plete this initial article in List- 
ing six. Printer printout is 
omitted at this stage because of 
the need for a number of other 
print PROCedures. 


Scrolling 


Note how, at 840, we have 
used PROC ‘seeline forthe third 
time. Lines 850 to 870 stops the 
screen scrolling after 20 items 
have been printed and waits 
for further instructions. Line 
900 is essential, otherwise when 
the x loop was completed the 
program would zip straight 
back to the menu. Finally, at 
940, you need to be able to save 
the program. You are now 
ready totry it out. This isa very 
basic program with no provi- 
sion as yet for amending data, 
abstracting or sorting. If it 
doesn’t work, or you get error 
statements on the screen, you 
have mistyped or omitted 
something — the QL is never at 
fault. If this happens, hold 
CTRL and press SPACE-bar. 
Type ‘list’ and ENTER then 


quickly hold CTRL and press 
F5. This stops the screen scroll- 
ing. Pressing. F5 alone restarts 
it. You can now work through 
the listing while checking the 
lines for errors. An error state- 
ment at the bottom of the screen 
even tells you (usually) which 
line to check. There are some 
excellent and clear instructions 
in the QL User Guide for cor- 
recting program lines. Read the 
Introduction, p.5 (Using the QL) 
and Beginner’s Guide, p.9 (Ed- 
iting a Program). You can eas- 
ily get back tothe menuanytime 
by ENTERing the word ‘menu’. 
The word ‘database’ in lines 
960-990 should be altered to 
something of your choice. 


Suggestion 


Suggestions for a try-out are 
as follows: 


1.Formattwo cartridges, each 
at least three times if new. (See 
the manual.) 

2. Go to menu, press A and 
answer the questions, having 
decided on a name for your 
data. 

3. Back at the menu, press C, 
Typein about two dozen names 
and numbers then exit as per 
screen instructions. 

4. Having automatically re- 
turned to the menu, press B. 

5. Press E to see how the data 
looks on the screen. 

6. Press H to save the pro- 
gram. 

7. Either switch off the com- 
puter after removing the car- 
tridges temporarily, or pressthe 
reset button at the side. 

8. Type ‘Irun mdvl_your 
name’ and ENTER. run both 
loads and starts running in one 


Oo. 

sy Press A and you should be 
back in business once more, 
ready for further data. Press E 
to check that all previous data 
is back in. It is no good pressing 
D, F or G since these 
PROCedures are not yet writ- 
ten, but you could try, just to 
see what'happens. 


The next article increases the 
number of fields and adds ad- 
ditional PROCedures, It there- 
fore also includes a number of 
short cuts for altering or enlarg- 
ing a program and indeed, once 
hooked on programming you 
will be forever tinkering and 
smoothing out and streamlin- 
ing your progs. 


iS FITWARE FILE | 


FIVE 
GAME | 
PACK 


INFORMATION: 

Program: Five Game Pack. 

Supplier: C.G.H. Services 
Cwm Gwen 
Hall, Pencader 
Dyfed 
SA39 9HA. 
£12.50 disk only. 
(p&p inc.). 
Expansion not 
required. 
Compatible 
with Minerva 
and GoldCard. 


John Shaw got 
his hands onaset 
of classic games, 
and we haven’t 
been able to prise 
him away yet. 


reford Davies is 

to be commended 

forprogramming 

this pack in such 
a professional way. The five 
games, all of which are well 
known, have been revitalised 
by first class graphics and 
speed of execution. 


Roulette 


In Roulette, the roulette wheel 
and betting table are set out on 
the screen, side by side and are 
visually excellent. For those of 
you not familiar with the intri- 
cacies of this famous casino 
game, Wreford has provided 
graphical instructions on the 
press of <F1>. It demonstrates 
the different ways in which bets 
may be placed and the mean- 
ings of such words as Manque, 
Passe, Pair and Impair. In ad- 
dition the odds for each type of 
bet are shown. 

To place a bet, your coin is 
placed in position by moving 
the cursor and then pressing 
any number from 1 to 0 (0 bets 
10). 
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. Old Glory in all its glory 


Othello, or Reversi —a 
game of cunning... 


Your initial allowance is 
£100.00. Once satisfied with 
your system you press <F5>. 
This sets off a clever graphical 
display where the ball spins 
around the wheel in an ever 
decreasing spiral, generating a 
sound quite close to the real 
thing. 

When the moment of truth 
occurs and the wheel stops 
spinning, the computer either 


credits or debits your account 
according to how you fared. 


Results 


A third screen may be called 
up which gives all the statistics 
of your endeavours. The se- 
quence of results and the 
number of Spins, Highs, Lows, 
Evens, Odds, Blacks and Reds 


Quadliner, or four-in-a-row 


A scrambled Old Glory. 
You also get the Union jack 
and the Rising Sun... 


are all made available to you to 
increase your chances of mak- 
ing a fortune, 

Try the ‘Double if you lose - 
original stake if you win’ sys- 
tem. See whether it is worth 
going to a real Casino! 


Quadliner 


This is an established party fa- 
vourite, better known as ‘Four 
in a Row’. In this smooth-run- 
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Mindbender, a logical chal- 
lenge of colours. 


. and see how you fare! 


ning version, you drop discs 
into slots by moving the cursor 
keys and using the space bar to 
drop them. The object of the 
game is to get four discs in a 
row, either horizontally, verti- 
cally or diagonally, taking turns 
with the OL to drop them. A 
score is kept and displayed at 
the end of each game. This is a 
good game against a very chal- 
lenging opponent. 


HIRDBENDER 


INSTRUCTIONS 


Mindbender 


This is the OL version of a puz- 
zle which was produced under 
various names, the most nota- 
ble being Mastermind. For 
those readers who have never 
played the game, the essence 
of the challenge is as follows: 
The QL prompts you to 
choose a number of colours 
(between 3 and 8). The display 
then shows a grid, five slots 
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In Roulette, you can pit 
your luck against the 
wheel. . 


deep andeightslots wide. Your 
task is to establish the undis- 
closed sequence of five colours 
chosen by the program and the 
sequence in which they are 
stored. You have eight tries and 
the slots fill up with your cho- 
sencolours. Youare given hints 
as to your progress and to how 
well you are doing, e.g. ‘four 
colours correct — 2 in the right 
place’. 


SOFTWARE FILE 


This is an absorbing game for 
those who enjoy logical mind 
challenges. 


Othello 


Othello, or Reversi as it is 
sometimes known, is a board 
game simulation played 
against the QL. 

The object is to place discs on 
the board in such a position as 
to trap your opponent's discs 
between them. This then auto- 
matically changes them to your 
colour. Your opponent is, of 
course, trying to do the same 
and as the game progresses the 
discs change back and forth 
reflecting the skills of each 
player. The waiting time is very 
low and the QL a very clever 
player. A full set of instruc- 
tions is provided on-line. 

A tip for those of you who are 
prepared to take on the QL: try 
and get your colour counters 
in the corners and on the sides; 
if you don’t then the QL cer- 
tainly will! 


Flag Puzzle 


Here is a challenging puzzle if 
there ever was one. The open- 
ing screen gives you a choice 
between three flags, the Union 
Jack, Old Glory (Stars and 
Stripes) and the Rising Sun 
(Japanese). You are then asked 
fora choice of difficulty (0 to 9). 

The screen then clears and 
momentarily your chosen flag 
is shown complete. It is then 
broken up into squares which 
are then shuffled around ac- 
cording to the level of diffi- 
culty you chose, 

Your job is to unscramble 
them using the cursor keys 
which move the squares 
around. The 0 level is com- 
paratively simple, involving 
some twelve orso moves. Level 
9 is mind boggling. Squares 
dash around the screen at a 
frantic rate. 

Fortunately Wreford has pro- 
vided a Help facility which, if 
taken up, points an arrow in the 
direction in which the square 
should go. If you get totally lost 
then there is an excellent com- 
mand which will totally retrace 
all your steps and indeed all 
those needed to finish the game. 

This Games Pack is very pro- 
fessionally produced and will 
easily stand comparison with 
any other commercially writ- 
ten program. Ihave thoroughly 
enjoyed playing eachand every 
game and I feel most readers 
will as well. 


33 


DIY 


TOOLKIT } 


Simon Goodwin wraps up the _DEF functions, 
explores QL bugs, and uncovers useful Rom 
vectors never revealed by Sinclair. 


ast month DIY Toolkit introduced 

three new SuperBasic functions, 

_DEF%, _DEF$ and _NAME$. 

This column presents the remain- 
der of the assembly code listing, and dis- 
cusses the developments added to the 
prototype sent in by reader Anders 
Hartzellius. | also reveal eleven previously- 
undocumented rom routines that are eas- 
ily called from Basic or code. 

Anders uses Minerva 1.79 which cor- 
rects many faults of Sinclair roms. | have 
shuffled the registers used to suit older 
roms which clobber registers D4 and D6 
when fetching parameter values. Alas, 
this complicates the listing. 

Anders' code assumeda character height 
of ten pixels when scrolling. This is fine for 
most QL setups but upsets NTSC tv users, 
who expect characters to be some multi- 

| ple of eight pixels in height. It also goes 
wrong if double-height characters are se- 
lected, such as CSIZE 0, 1 or CSIZE 3, 1. 
The revised code reads the channel defi- 
nition's YINC, the height of lines in pixels, 
and scrolls accordingly. 

The prototype made two slips in passing 
and returning values. The channel ID was 
not removed from the Maths Stack, caus- 
ing ‘creep’, as | discovered when PRINT 
100 + _DEF%(#2) gave the wrong an- 
swer, The #2 was left on the stack, getting 
in the way of the first number. To fix this | 
added the instruction ADDQ.L #2,BV_RIP 
(A6) after the code that reads the integer. 

The most subtle slip was in_DEF$, and 
_NAMEG$ too, at first. The code to move 
text from the Name List to the Maths Stack 
copied one byte too many. This is an easy 
mistake to make, and tricky to spot when 
you have to contend with DBRA, odd and 
even boundaries and byte or word length 
prefixes, which may or may not be in- 
cluded in the total. 

My attention was grabbed when PRINT 
_DEF$ seemed to work fine, but PRINT 
"QL" & _DEF$ crashed the JM rom. The 
extra byte stacked by _DEF$ clobbered 
the length of the first string above it on the 
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stack, waiting to be concatenated. An- 
other QL locked up when | tried again, 
using the Minerva 1.76 rom. 

Problems are almost inevitable if pro- 
grams address and modify the wrong bytes 
of memory. Such faults can be hard to pin 
down, which is why it is important to give 
them a chance to show up in testing. 


Code confident 


One way to become confident of such 
code is to step through it using a monitor 
such as Qmon, checking register values at 
every stage of a real example. It is wise to 
make sure that both odd and even length 
strings are correctly handled. Basic names 
are a special case, as lengths fall into a 
small range, but strings may have any 
length from zero to 32K, or thereabouts. 
Check both ends of the range, and re- 
member it is better to report an error than 
to allow undefined or inconsistent behav- 
iour. 

Turbo Toolkit explicitly limits strings to 
32764 bytes, allowing two bytes for the 
length with no risk of signed word overflow 
when the total is rounded to an even 
number. Remember that the 68008 uses 
signed word arithmetic and considers that 
32766 + 2 equals -32768. Sinclair roms 
get horribly confused by negative string 
lengths; it is wise to make sure that your 
programs cannot generate them. 

| explain this not to embarrass Anders, 
whose suggestions were the best docu- 
mented that | have received from readers 
in many months, but to show how the 
same bugs crop up time and again in 
SuperBasic extensions. | catalogued these 
in my coverage of ‘deadly sins’ for QL 
World in September and August 1988, but 
| keep finding and making and fixing famil- 
iar mistakes. 

It is important to test functions by calling 
them from the middle of expressions, as 
well as printing the result directly. Some 
problems appear if you run a loop, calling 


oe 
A 
ul 


> 


— Se 


. By, 


~ 


< 


a function and printing the result and free 
memory alongside. If the stack is 'creep- 
ing' the free memory figure shrinks every 
so often, as more and more rubbish builds 
up. You need the loop as Basic allocates 
memory in steps of 512 bytes or more, so 
a couple of extra bytes do not show up 
immediately. 

Another good test of programming tools 
is to try them with a large program in 
memory. | use the Turbo parser, over 
130K of Basic tokens with about 150 pro- 
cedures and functions, and a trivial but 
enormous program made with a FOR loop 
that printed dummy lines to a file. Word 
addressing problems only show up when 
locations are displaced by more than 32K 
of ram. 

After fixing the Maths Stack | modified 
_DEF% and _DEF$ to store Name Table 
offsets relative to the start of the table, 
rather than the start of Basic. The program 
file and other areas come before the Name 
Table, so simple word offsets are inad- 
equate if a large program is loaded. 

The revised code subtracts the value of 
BV_NTBAS from each offset before stor- 
ing itin the table. As each word is retrieved 
it is moved to a data register with the top 
two bytes clear, so offsets up to 64K are 
valid, before BV_NTBAS is added back. 
You can see this in the Listing, at 
MOVE_LOOP. MOVEA.W 0(A3,A6.L),A5 
would not work for words over 32767. 

It might be simpler to store and recall 
long words, but that would only accommo- 
date half as many in a given amount of 
buffer space. The lower three bits of each 
word are redundant, as entries are eight 
bytes long, but it is not worth shifting them 
out and in to boost the capacity to 65535 
names as the Name Table can never get 
that big. | could have chosen to store 
offsets in the Name List, rather than point 
at the Name Table entries. It makes little 
practical difference. 

Anders stored the words by pushing them 
onto the A7 stack, with a limit of 51 entries 
to prevent stack overflow. The prototype 
restored the original value of A7 when 
finished. This worked fine, as long as 
SuperBasic did not move, but that was not 
a valid assumption. 


Sinclair/QL World February 1992 


QL World DIY TOOLKIT _DEF%, _DEF$, _NAME® functions, version 1.5 
(c) Anders Hartzelius 1991, DIY changes (C) 1991 Simon N Goodwin 
PART 2 — CONTINUED FROM LISTING 1 of QL World January 1992 


* 
io_fbyte 
ia_sstrg 
sd_pos 
sd_tab 
sd_prow 
sd_nrow 
sd_scrol 
sd_setst 
sd_setin 
bv_ntbas 
by_rip 
by_chrix 
err_nc 
err_or 
enter 
space 
esc 

up 

down 

* 


* Highlight the 
* 


choose 


test_enter 


test_down 


scroll 


noa_scroall 


equ 
equ 
equ 
equ 
equ 
equ 
equ 
equ 
equ 
equ 
equ 
equ 
equ 
equ 
equ 
equ 
equ 
equ 
equ 


$81 
$07 
$10 
$11 
$15 
$146 
$18 
$28 
$29 
#195 
$59 
$1lla 
=f 
-4 
$0a 
32 
$ib 
sda 
$d 


Trap key to fetch a byte 
Trap key to send a string 
Set row & column position 
Tab cursor to a column 
Previous row 

Next row 

Scroll window 

Set STRIP colour 

Set INK colour 

Offset to Name Table 
Limit of RI Stack 

Vector to check RI space 
WOT COMPLETE error code 
QUT OF RANGE 

Code for ENTER key 

Code for SPACE bar 

Esc 

Up arrow 

Down arrow 


first name and allow selection from the menu 


moveq 
moveq 
moveq 
bsr 
swap 
moveq 
move.w 


#8,d1 

#0,d2 
#sd_pos,dd 
traps 

d4 

wa, 1 
@(a3,a6-1),d1 


byv_ntbas(aé),d1i 


di,aS 

invert 
print_name 
invert 
#io_fbyte,do 
traps 
#esc,dl 
test_enter 


#space,d1 
dane 

#up, di 
test_down 
(ad) ,a3 
key_loop 
#2,a3 
#sd_prow,d& 
arrow 
#down, di 
key_loop 
#sd_nrow,dé 
#2, a3 

a2,as 

arrow 

#2,a3 
key_loop 


#8,d) 
#sd_tab,dé@ 
traps 
print_name 
dé,0@ 

traps 
ne_scroli 
#sd_scrol,ds 
d4,di 
#sd_prow, dé 
scroll 

di 

traps 

“0,1 
#sd_tab,dd 
traps 

move loop 


#4,d0 
2iaS,aé6.1),d# 
a4,d0 

d@,al 

#0,d2 
Blal,ab.1),d2 
d7,d2 

len_ok 

d7,d2 

#1,al 
#io_sstrg,dd 
R4 


#3 
de 
return 
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Column 
Row 


AT #X,8,0 

Retrieve char. height.W 
Prepare for unsigned maths 
Di:= index in name table 
Relate to start of Table 
AS is offset inside BASIC 
Inverted video 


Revert 


Get keypress 
ESC ? 


Not complete 
Return to basic 
ENTER ? 


SPACE 7? 
UP ? 


First entry ? 

Yes: ignore 

No: previous entry 
Cursor up 

Move cursor 

DOWN ? 


Cursor down 

Next entry 

Past the last entry ? 
No: move cursor 

Yes: stay at the end 
Wait for keypress 


First pos on line 
Move cursor 
to start of line. 


Move cursor up / down 


Out of range ? 
Yes: scroll window 
Scroll one iine 
Which direction 7? 
Scroll down 

Scroll up 


First pos on line 
Move cursor 


Wait for keypress 


Prepare for unsigned sums 
De@ -> entry in name list 
fdd NL base address 


Clear high bytes of D2 
D2!:= name length 
Name too long ? 


Truncate name to fit window 
Al -> name 

Print string 

Signal Aé reiative 


IO trap 
Error ? 
No: return to caller 


DIY TOOLKIT 


The QL may re-allocate transient pro- 
gram memory at any time as it runs other 
tasks. QDOS moves all the SuperBasic 
memory contents and tweaks SuperBasic's 
A6 and A7 registers so they still point to the 
right part of memory. It is never safe to 
save and restore the value of USP A/7, 
because the restored value will be wrong 
if SuperBasic moved after A7 was saved. 

| decided to fix this and remove the limit 
on the number of names in the menu, 
storing the index in SuperBasic's Buffer 
area. This always contains room for at 
least 128 bytes, or 64 name indices, and 
grows if long program lines are loaded or 
entered. There is an easier way to expand 
the buffer, but it has never been docu- 
mented — until now. . . 


Code vectors 


Machine code routines inside Qdos are 
accessible in two ways. Most can be in- 
voked by the use of TRAP instructions, 
which | documented in July's QL World 
and DIY Toolkit Volume T. Many other 
routines are accessible to Basic CALL or 
machine code JSR instructions, via 'vec- 
tor' addresses stored in a table early in 
every QL rom. 

The table of vectors always starts ata 
fixed address, but the values therein vary 
between rom versions, as Sinclair and 
others have shuffled code around. As long 
as you read the vectors you can call any 
routine without worrying about its address 
in a particular rom. 

Each entry is a word — the address of a 
rom routine. The actions performed, and 
the parameters needed, make it most use- 
ful to call vectors from machine code, but | 
you can reach them from SuperBasic. You 
could reserve NUM bytes of space for the 
interpreter's maths stack with CALL 
PEEK_W (282), NUM. The vector address 
for BV.CHRIX is 282, and the parameter 
NUM is passed to the code in register D1. 

Most of the vectored routines are in the 
first 32K of the QL rom, but you must add 
16384 to the value from the table when 
calling microdrive routines, as they are 
located in the second (16K) QL rom chip. 
It cannot be addressed directly by a signed 
word, which can only reach address 32767. 

By default the 68008 considers values 
over 32767 to refer to negative addresses, 
ranging from -32K to -1, but unsigned 
values from 0-65535 are more useful if you 
wish to refer to a table with a fixed start. 

The code for these DIY extension func- 
tions is often complicated by the need to 
distinguish between signed and unsigned 
words. Many bugs in SuperBasic and the 
Psion packages have stemmed from the 
unplanned use of signed arithmetic. 

A case in point is the SuperBasic Name 
Table, which contains word offsets that 
pointattextin the Name List. The maximum 
capacity of the list is doubled, from 32K to 
64K, if unsigned offsets are used, but extra 
code is needed to stop the QL treating the 
extra values as negative numbers, prob- 
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cmp. w #err_or,da 
beq.s return 
addq.1l #4,a7 
tst.1 d@ 

rts 


qui t_out 
return 


# 
move.1 d5,di 
swap as 
moved 
ber.s traps 
swap di 
moveg 
bra.s traps 

clraw d? 

swap d?7 


movea.l by _riptad),al 


#2,d1 
R3,d7 
alitoc 
#0,de 


moveq 
cmp.b 

beq.s 

moveq 

move.w 
adda. 1 
add,b 

addq.w 
belr 


d@,aa 


#i,dl 
#G,d1 


move-1 di,d& 


movea.w by_chrix\w, aZ 


jor (a2) 


movea.1 byv_rip{aé),ai 


suba.1l 
move. 1 
cop.6 
bne.s 
MOVE. Ww 
move. i 
moveq 
rts 


dé,al 


#3,d7 
string 


d7,d4 
4a, da 


goodbye 
no_problem 


* 
string #2,d4 


Biai,aé.1) 


subq.w 
cle.b 
move.b 
addq-1 
addq-1 
dbra 
bra.s 


copy 
#1,a4 
Wl,al 
dé,copy 
goodbye 
# 

get _colours moveg aG,d1 
move.b 4S9(a@),d1i 
swap di 

move.b 7Hlad),d1 
bra.s ne_problem 
” 

get _csizes mover 
MOVE. 
move.w 
divu d2,d1 
subg.w #1,d1 

swap al 

move.w 48(a@)>,di 
swap di 

bra.s no_problem 


40,d1 
21a) ,d1 
38a) ,d2 


* 
define de. G,8,3 
name—* 

4,“ NAMES" 
@ 

defs—* 

5," _DEFS” 
@ 

deftn-* 

Ss, "_DEFx” 
@ 
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ably missing the list altogether! 

The standard rom vector table includes 
50-odd entries, from MM.ALCHP at ad- 
dress 192, which allocates Common Heap 
entries, to MD.SECTRat298, which reads 
a microdrive sector header. These are 
well-known and often used, listed in books 
such as Dickens' QL Advanced User 
Guide and Pennell's Qdos Companion. 

A further eight vectors were added in JS 
and MG roms, including Thors and 
Minervae; they point to tables and code 
used by the SuperBasic interpreter. Other 
vectors near the end of MG roms indicate 
language-specific options. 

The example call to BV_CHRIX is not 
very useful, as reliable QL functions re- 


#ed_setst,da 


#ed_ setin,dd 


2(aS,a6.1) ad 


@la4,ab6-1),d1 


4(a5,a6.1)},6(at,aé.1} 


@(a4,a6.1), tat, a6.) 


Out of range ? 
Yes: return to caller 
Return to earlier cail 


Dit=previous ink / strip 
Inkz=strip , strip=t=ink 


Sel strip ta ink 


Set ink to strig 
Cail 10 trap 


Retrieve the % / #® flag 
Al —> the RI Maths Stack 
At least 2 bytes needed 
Return 4 or $ 7 

Jump if % 

Clear high bytes 

Pick up offset, 8..465535 
A4 -> naae 

Diz= 2 + name length 
Make length 

even. 


Save number of bytes 
Request space on 
Maths Stack. 

Fetch new ri-stack 
Adjust pointer 


al,bv_rip(ladé) 


Return % or & ? 
Jump if # 

Stack line Neo. 
Result type 

No error 


Adjust count 
Clear length.H 
Copy bytes 
Adjust pointers 

Cepy the whole name 
Return to BASIC 


Clear odd bytes of Di 
Strip 

Make room fur ink 

Ink 


Clear high word of D1 
XSIZE 

¥INC 

D1.W i@ number of chars 
Don’t use least column 


Put YINE in high word 


No procedures 3 functions 
Offset to code 

Name length and text 
Align to a word boundary 
Offset to code 

Name length and text 
Align to a word boundary 
Offset to code 

Name length and text 
Align to a word boundary 


serve Maths Stack space as they go along 
— but it would often be useful to reserve 
space in other parts of the SuperBasic 
memory area. 

For instance, you might want to expand 
the Program File in a search-and-replace 
routine, or extend the Channel Table ina 
variant of OPEN. Code that generates 
values for SuperBasic may wish to make 
room in the Variable Values area. 

INPUT allows longer lines and com- 
mands like COPY and MORE go faster if 
you increase the size of SuperBasic's 
Buffer area. This is most important on AH 
and JM roms, which otherwise limit IN- 
PUT to 12B characters. 

Corruption of programs that use more 


than nine parameters or local variables in 
one DEF can be avoided by making room 
at the end of the Name Table. Allow eight 
bytes for every name, and then a bit more 
to be on the safe side, to prevent program 
corruption when using AH, JM and JS 
roms. 

It is hard work to extend Basic areas 
using the routines documented by Sinclair. 
BV_CHRIX will grab space for the Maths 
Stack, but the only other system routine to 
expand Basic is MT_ALBAS, MTRAP 24. 
This reserves space in the middle of the 
interpreter's memory area, above all the 
tables and before the stacks. 

If you need room somewhere else it 
appears necessary to move all the inter- 
vening stuff, adjusting various Basic 
memory pointers as you go along. This is 
a slow and fiddly process. Sinclair must 
have routines to do this sort of thing al- 
ready buried in the rom — but how can we 
get hold of them? 

Some of Anders’ questions prompted 
me to investigate SuperBasic storage al- 
location. In that process | uncovered a 
further eleven vectors that are reliable in 
all QL versions, from AH to Minerva; they 
are called in popular programs, yet they 
have never been documented. 

If you have explored the QL rom with a 
disassembler you may have noticed that 
the BV_CHRIX vector points to one entry 
in a table of routines that check for space 
in Basic tables and stacks. You can ac- 
cess other entries by adding standard 
offsets to the BV_CHRIX vector address. 

The table sets out offsets to check for D1 
bytes in each area. Thus, to reserve N free 
bytes at the end of the Program File: 


CALL PEEK_W(282) + 52, N 


| checked these on Sinclair's JM rom, 
Minerva 1.64, andon my Thor XVI version 
6.41; they should be the same on your 
rom, and every other. The order and off- 
sets of these entry points is fixed, even in 
Minervae. They are reliable as they are 
used by Toolkits and disk systems to 
expand the Channel Table. 

The_DEF functions use the SuperBasic 
Buffer area to hold the index to procedure 
and function names. This always has at 
least 128 bytes, allowing 64 names, butis 
usually larger, and can be expanded by 
SPACE bytes with CALL PEEK_W(282) + 
28, SPACE. 1000 bytes is usually plenty 
for MORE and the._DEF functions. 


Code commentary 


This listing continues from listing one in 
January's DIY Toolkit. Label CHOOSE is 
reached when the window has been filled 
with names. The program moves the print 
position to the top left corner of the screen. 
The INVERT subroutine swaps foreground 
and background colours so that the name 
appears highlit when re-displayed by 
PRINT_NAME. 

At KEY_LOOP the program reads a key 
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| J unbuffered modems, Comprehensive AS manual, 


with acallto!|D_FBYTE. A'bad parameter' 
error is detected here if you have chosena 
SCR channel, which does not allow key- 
board input. 

Anders' comprehensive error-traps come 
in handy again in the ARROW routine, 
which moves to a new line and scrolls the 
screen ifnecessary. The keyboard handler 
loads the required TRAP key into D6: 
SD_PROW to move up or SD_NROW to 
go down. The screen scrolls if the row 
TRAP indicates an ‘out of range’ error. The 
value of D6 determines the direction 
scrolled; the number of pixels comes from 
D4, set by last month's EXTOP call. The 
previous name is reprinted in default col- 
ours before the move takes place, so the 
highlight appears to move between names. 

Next comes a clutch of subroutines. 
PRINT NAME locates text in the Name 
List, and trims it if necessary to fit the 
window. The address in A1 is relative to 
A6, as itis inside SuperBasic, so TRAP #4 
is used before the name is printed with 
ID_SSTRG. The TRAPS routine is used 
throughout the listing. It returns only 
ERR_OK (no problem) or ERR_OR (out of 
range), propagating other errors to the 
previous caller, to be reported to the user. 

The menu functions end by jumping to 
DONE, which checks that there is room for 
the result on the Maths Stack and copies it 
into place. NAME$ joins in at STACKER. 

INVERT exchanges INK and STRIP col- 


The ULTIMATE operating system upgrade 
NKIT HIMERUA now wilh battery for 256 bytes 
rom, CRASHPROOF clock & interface (IC) for 

robots etc. Can qutoboot from battery rom, 
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schaduler-graphics (182 of Lightning) -s1ping 
hondking @ic/ WHEN ERROR! Second screen/TRACE 
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MEE to HK] UPGRADES: up to 1.79~£5. Rest FREE 
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QuaLsoft Terminal 


Viewdata¥TS2-0T100 OL TERMINAL EMULATOR 


Mult ldo ng for electronic pail, PRESTEL etc, 
CET dovntoad. Compatible with Tondata @connact 
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COMPUTER CLEANER 


HELP STOP POWER SUPPLY INDUCED LOCKUPS 
AND PROTECT COMPUTERS 
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Contain inductance, spike filters (three in 
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QRRS ~ UK's first Q@ scrolling board 
§L Echonai! around Europe, and FIDO netuait 


round 10mb of files including the WHOLE 
King James’ bibte! 


OTL 706 2379 UL e2deddeddbis Uthes 


QL REPAIRS 


QLs tested with Thorn EMI test rig 
and RON software 


CHOU harduare extra if required) 
E27 - 6 month guarantee 


FILE TRANSFER 


Prograns to transfer text AHD programs 
error free C(MODEM between computers 


fuailable for IBN PC and compatibles, 


ATARI ST and Sinclair &. Connects to 
Psion organiser via Psion comms |ink 


QuaLsoft progrom (per w/c) 
Serial teod (rome 2 computers)... E10 


Complete package for 2 computers. £25 


Prestel: 6172498653 


ours, swapping the values in D5 at each 
call. GET_COLOURS and GET_CSIZES 
are the two EXTOP routines called to read 
channel definition details. Each returns a 
pair of values in the high and low words of 
D1. They could be combined by packing 
values together or using A1 as well as D1 
to return all four results. 

Atthe end of the listing, DS.W 0 is used to 
ensure that table values are at even ad- 
dresses. This is not strictly necessary, as 
good assemblers do not try to put word 
values at odd addresses, where the 68008 
cannot reach them. The Computer One 
assembler uses ALIGN and other assem- 
blers use CNOP 0,2 for the same effect. 


Code extensions 


The existing code could be usefully ex- 
tended in several ways. When editing large 
programs it would be convenient to be able 
to page through the menu, or skip directly 
to the start or end, as most recently added 
names will be at the end. Qptr users might 
add pointer control, so that names could be 
selected with a mouse or track-ball. 

Complete source, binary code and docu- 
mentation for these functions is available 
ondisk or cartridge from DIY Toolkit, Cwm 
Gwen Hall, Pencader, Dyfed, Cymru 
SA39 9HA, tel. (0559) 384574. These 
routines are part of Volume A, along with 
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CODEVEC, ALIAS and INVERSE from 
November's QL World, and variants. 

Material from past DIY Toolkit columns, 
and much besides, is available in 18 vol- 
umes priced at £3 each, plus £4 per order 
to cover disks, processing and postage. 
Bargain Bundles of six volumes cost £20 
each. Please enclose one formatted car- 
tridge for each volume required on 
microdrive. 


Area Name 

RI Stack 
Backtrack Stack 
Temporary Graph Stack 
Name Table 
Return Table 
Buffer 

Token List 
Name List 
Variable Values 
Channel Table 
LIST Line Table 
Program File 


Table one: BV_CH__ X Vector offsets. 


Dyfed, Cymru, SA39 9HA 
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or QL programmers constricted 
by the slowness and non-multi- 
tasking capability of SuperBasic, 
or for the serious programmers 
thinking of writing code for a number of 
machines or thinking to the future when 
they have to upgrade their trusty QLs, 
moving over to Pascal, in particular to 
Prospero Pascal should seriously be con- 
sidered. 

Pascal is a truly portable language and 
much easier to learn and program in than 
the ‘C’ language. SuperBasic in many ways 
is very similar to Pascal and this should 
make the transition from SuperBasic to 
Pascal much easier. 

Prospero software versions of Pascal not 
only conform to the IS0 7185 level 0 Pascal 
standard, but are also available for a wide 
range of different computers - CPM, MS- 
DOS, OS/2 and the 68 K series: QL and 
Atari ST. Prospero are one of the main 
language houses offering a wider audi- 
ence to C, Pascal and Fortran than even 
Microsoft and Borland who concentrate 
mainly in the MS-DOS and OS/2 arena. 

Prospero’s Pascal range not only offers 
one of the most powerful of the Pascal 
implementations but provides a natural 
upgrade route. For me, moving from 
ProPascal (CPM) on my Memotech FDX 
system to the QL was painless. Approxi- 
mately 80 per cent of the code was as CPM. 
The remaining 20 per cent was the ma- 
chine dependent code - sound, graphics 
and file handling quirks brought about by 
the different Operating systems, like 
filename convention (ie size and struc- 
ture). 


Effortless 


Converting SuperBasic programs was 
just as effortless, even more so as the 
Graphic command extensions provided 
by Prospero were almost identical to 
SuperBasic. Pascal though, is a bit stricter 
than SuperBasic with respect to type as- 
signmentsand unlike SuperBasic certainly 
does not allow any form of coercion (see 
QL User Guide, Concepts page 46). 

However, this does force the program- 
mer to plan the design of the program 
more thoroughly and ultimately to the 
generation of better code. The obvious 
benefits of Pascal over SuperBasic were 
the ability to multi-task, speed of execu- 
tion, compactcodeand compatibility when 
upgrading to a different computer. 

In addition to the standard Pascal lan- 
guage, Prosperoimplementations provide 


AYORTWARE FILE 
PROSPERO 


PASCAL 


With programmers who are interested in Pas- 
cal in mind, A F Wilson tries out Prospero 


Software ProPascal. 


anumber of powerful extensions, many of 
which are universally accepted, even 
Borland’s Turbo Pascal compilers adhere 
tothem. In particular, floating-point arith- 
metic and dynamic string handling. 

The ProPascal range adheres to the same 
extensions throughout the different im- 
plementations whether on the QL or OS/ 
2. However, one or two specialist com- 
mands are still needed to access the differ- 
ent operating systems, ie QTRAP on the 
Sinclair OL or SYS on the Atari ST. 

ProPascal costs £101.50 and is available 
from Prospero Software or from TK 
Computerware. ProPascal consists of 3 
microdrive cartridges, PRL rom (version 
1.51) and an A5 hardback ring-binder 
manual. Figure one contains a list of what 
is found on the three microdrives and a 
brief description of their function. The 
obvious omission was the lack of Ascii or 
text Editor. However, this was no big dis- 
appointment for the QL programmer who 
is blessed with a number of excellent Ascii 
editors. 

An A5 hardbacked ring-binder manual 
contains all the formal information on the 
Pascal language and the ProPascal exten- 
sions with one or two examples. A number 
of demonstration listings are provided on 
disk, these illustrate key programming 
techniques in Pascal. The manual also 
contains information on interfacing For- 
tran and 68 K code with Pascal. 

The manual lacks a decent tutorial. How- 
ever, as Pascal is one of the main teaching 
languages there are a number of excellent 
books around catering for the novice to 
the advanced user: 


Mastering Pascal Programming by E 
Huggens, published by MacMillan (for 
the novice user). 

Pascal, an Introduction to Methodical Pro- 
gramming by W Findlay and D A Watt, 
published by Pitman (for the advanced 
user). First of all disconnect the QL power 
supply and plug in the development 
Prospero Resident Library Rom (v1.51) 
into the cartridge port at the back. Recon- 
nect the QL power supply and switch on. 
The opening page after switch on will 
indicate that PRL has been installed cor- 
rectly. 

The next step is to make working copies 
ofthe program toeither disk or microdrive 
depending on yoursystem.IhaveaJSrom 
QL with extended ram and a disk inter- 
face. Therefore I copied the contents of the 
three microdrives to disk 1-marked DISK 
version. This was repeated to disk 2 - 
marked RAM version. 


Verifying 


Running the utility pcheck (exec 
flpl_pcheck) on disk 1 and subsequently 
on disk 2 to verify that the copying was 
okay (no problems with the WCOPY com- 
mand on TK2). The next step was to up- 
date some of the programs to recognise 
that they are to be run from disk or ram. | 
Utility setdev will do this, (see manual 
part IID. 

Microdrive users will need tosplitup the 
compiler onto three microdrives due to 
capacity restrictions. Prosperorecommend 
that files PAS, PROPAS1, PROPAS_ERR 
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Pascal Programs Provided by 
PROPASCAL for the Sinclair Ql 


Figure 1: 


Sample boot file for QPAC2 
users of ProPascal 


Listing 2: 


compiler control program « 
pass 1 compiler,generates 
pseudo code 

pass 2 compiler,generates 
RELocatable code 

error messages 


100 
110 


REMark - extensions Loaded 
base=RESPR(14270): LBYTES 
'fipl ptr gen',base: CALL base 
base=RESPR (9992): LBYTES 
'flpl wman’,base: CALL base 
130 base=RESPR (10846): LBYTES 

'flpl hot_rext',base: CALL base 
140 base=RESPR(6074): LBYTES 
'flpl xtras',base: CALL base 
REMark if you have ROM PRL, then 
miss out line 145 
base = RESPR(16314): LBYTES 
"mdvi PRL' ,base:CALL baset8 


PROPAS1 


PROPAS2 
120 


PROPAS. ERR 


GST linker 

pascal library 

library start module 
library end module 
linker command file 
software pascal toolkit 


PASLIB_ REL 
PLINT_REL 
PLEND_ REL 
PAS LINK 
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librarian 
cross reference generator 


base=RESPR (34812): LBYTES 
'flpl Qpac2', base: CALL base 


ProPascal copy verifier 
change media defaults 
change stack requirements 


remove pascal 


include file - QTRAP proc 
inciude file - Graphics 


GRAPRIC_ PAS 
COMPARE PAS 
SQUARE PAS 
LIFE_PAS 
RESULTS PAS 


demonstration 
demonstration 
demonstration 
demonstration 


be stored on one microdrive and PROPAS 
and PROPAS2 and PROPAS_ERR on the 
second and the remaining files on the third 
microdrive. | would recommend users 
upgrade the ram capacity of their QLs to 
take advantage of the speedier ramdisk. 

| Don’t forget to update the boot file. 

Listing two, described fully under the 
Multi-tasking heading shows a typical 
bootup file for ProPascal running on Qpac2. 
Lastly, the Pascal source text generated 
with the Editor should be kept separate 
from the programs and all files must end 
with the ‘_PAS’ extension. 

The two-pass compiler converts the Pas- 
cal program (source text) intoa relocatable 
binary machine code file (object code). 
Typing ‘exec flp1_pas’, invokes the Pascal 
controller program (PAS). PAS requires 
the filename (without extension) of the 
Pascal source text to be entered, ie 
flp2_square and the compile time options: 

* Compact code or Faster speed 

¢ ISO only Pascal 

* Pointer / Indexing / Assignment checks 

* Log/Prn files 

¢ Track source names and Line numbers 

at runtime. 

PAS hands over this information to 
PROPAS1 which checks the source text 
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REMark TK2 EXT for Trump Card users 


? window 


listing 
listing 
listing 
listing 


HOT GO 


syntax and if legal coverts it to pseudo or 
intermediate code. Any errors are extracted 
from PROPAS ERR and echoed to the 
console, and echoed to a LOG file on disk. 
There are 405 different errors that can be 
highlighted compared with the feeble 22 
available in SuperBasic. 

PAS only passes valid pseudo cade to 
PROPAS2 for the final part of the compi- 
lation. The pseudo code is converted into 
a relocatable binary file conforming to the 
Sinclair Relocatable format. The file gen- 
erated has _REL as the extension. 


Libraries 


The next step is to link the REL code with 
the Pascal libraries. The linker used is the 
standard GST linker as this conforms to 
the Sinclair REL format. The result is a 
binary file, with the _BIN extension. The 
BIN file can be EXECuted using exec 
flp1_fname_bin. The BIN file can also be 
multitasked with other executable files. 

Note that either the rom PRL or the soft- 
ware PRL must be initialised before the 
file will execute properly. PRLis a Runtime 
Pascal toolkit containing the most used 
Pascal commands. Runtime toolkits mini- 
mise ram constraints and enable a number 


ERT HOT RES ('e’,'flpi _edt_bin','i') 
ER'l’ HOT LOAD 
ERT HOT LOAD 
ERT HOT. LOAD 
ERT HOT LOAD 
ERT HOT LOAD 
ERT HOT WAKE 
ERT HOT PICK 


('p', 'flpl_pas’) 
('1',’£lpl_link') 
('d', 'flpl_dectohex') 
(‘h', 'f1pl_hextodec') 
('n','f£lpl_noqns') 
('x' , *"Exec') 

('b' 5 a] 'y 


of Pascal programs tobe runconcurrently. 
This was particuarly important before 
cheaper ram expansion, The TurboBasic 
SuperBasic compiler also requires a simi- 
lar Runtime toolkit — called XTRAS. 

The bulk of the Pascal program will use 
standard or extended Pascal Functions/ 
Procedures provided. During the linking 
stage, the linker will extract the REL code 
from the Pascal library and link the REL 
program file to produce the BIN file. 

Any part of the program which draws 
commands from say 68 K or from Fortran 
REL libraries should be included in the 
linking stage. Note that only REL libraries 
that conform to the Sinclair REL format 
are suitably ProFortranand the GST macro 
assembler both do this. 

If you do use a number of different li- 
braries then I suggest you write a Linker 
command file like the one in Listing one. 
When you come to link your REL program 
with the libraries all you have to enter is 
flp_2 program flp1_pas. “pas” in this case 
is that contained in listing one. The two 
main libraries here are PASLIBand CURS. 
CURS is a 68 K rel file that allows the 
cursor to be switched on and off in differ- 
ent windows, similar to the toolkit 2 com- 
mands CURSEN and CURDIS. 
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Listing one: Linker Command File: 
Link_pas 


; Linker file for linking Pro 
; Pascal programs - flp vers. 


INPUT FLP1_PLINIT 
INPUT * 

LIBRARY FLP1_PASLIB ;_rel 

LIBRARY FLP2_CURS _ ;_rel 
INPUT FLP1_PLEND ;_rel 
DATA 4K 

COMMON DUMMY 


;_rel 


Listing 3: 
Example of Pascal 
CONST 


This package comes with an excellent 
librarian program. The librarian allows 
the user to build new, or append existing, 
libraries. Eventually, you will have pow- 
erful libraries available in for instance, 
Statistics, Finance, CAD/DTP, etc. 

Table one summarises the media effect 
during compiling. The results were inter- 
esting to say the least. There is little ad- 
vantage to be gained by running Propas1 
and Propas2 from ram over flp or mdv, 
flp being my personal choice as all the 
files are on one disk and no lengthy copy- 
ing of the Pascal files to ram at boot up. 
However, when the Pascal source text 


PROGRAM exam; 


and resulting pseudo code and REL code 
are stored to ram disk then a definite 
speed advantage is gained. Also as the 
code becomes bigger, say 50-60 K the 
better the overall speed benefit. Propascal 
compiles at a rate of 1858 to 2764 bytes/ 
mun. 


Table one: Pascal source text (data) 
was compiled using Propas 1 & 2 
(Prog) giving a REL file with: 


Lines = 793 
Code= 9444 
Data = 1036 


{ Lines= 60 Code= 598 Data= 8 } 


sv_ramt =163872; 
sv_arbuf=163978; 
kilobyte=1024; 


TYPE 


qladdrbus=0. .2147483647 ; 


VAR 


lastkey,ramsize:qladdrbus; 


{ae ee User Functions WHE HH IK I } 


{ 32 bit } 


FUNCTION peek W(peekaddr:qladdrbus) :qladdrbus; 
{ numbers stored in MSB/LSB format in RAM. } 


Begin 


peek W:=peek (peekaddr+1)+ (peek (peekaddr) *256) : 


end; 


{ peek W } 


FUNCTION peek L(peekaddr:qladdrbus) :qladdrbus; 
{ numbers stored in RAM in MSB/LSB format } 
{ (addr+3 * 2°0)+(addr+2 * 2°8)+(addrt+l * 2°16)+(addr+0 * 2°24) } 


begin 


peek L:=peek (peekaddr+3) + (peek (peekaddr+2) *256)+ 
(peek (peekaddr+1 ) *65536) +( peek (peekaddr) *16777216) ; 


end; 


{ peek_L } 


{* Graphics extensions to PASCAL - machine dependent ( Q1 - QDOS ) *} 


PROCEDURE mode(highres: boolean) ; 


PROCEDURE window(VAR w: text; 


PROCEDURE cls(VAR w: text; part: integer); 


BEGIN 


mode (true) ; 
window (output ,420,160, 20,20); 
cls(output ,0); 


width, height,Xorigin,Yorigin: integer); 


{ main program } 


ramsize:=peek L(sv_ramt); 
lastkey:=peek W(sv arbuf) ; 


writeln(output,* Ql Ram Size is 


EXTERNAL ; 


EXTERNAL ; 


EXTERNAL ; 


{ Monitor mode } 
{ redefine/reposition default window } 
{ cls whole window } 


* trunc(ramsize/kilobyte):4 ,’ K '); 


writeln(output,' Last Key Pressed ASCII number was ',lastkey ); 
writeln(output); 


writeln(output,' Press ENTER to exit '); 


readln(input) ; 
END. 


Sinclair/QL World February 1992 


Media Propas! Propas2 Total Speed 
Prog Data <——-seconds——> Factor 


165 
165 
150 
120 
120 


305 
305 
275 
215 
205 


140 
140 
125 


I have used Propascal as a stand-alone 
package, attempted to use with Taskmaster 
before opting for Qpac2. Propascal is fully 
compatible with both Taskmaster and 
Qpac2, however, it is totally unworkable 
under Taskmaster, 

The difficulty with Pascal and Taskmas- 
ter isa simple one. All ProPascal programs 
on completion remove themselves from 
ram, similar to NEWing in SuperBasic 
whether compiling or linking. This means 
that they are also removed from Taskmas- 
ter, as Taskmaster requires memory resi- 
dent programs which only remove them- 
selves from ram when the user selects, for 
instance — QUIT as used for Quill or Editor 
or Abacus etc. As a result using Pascal 
within this environment is useless. 

On the other hand, Qpac2 is ideal for the 
job, see listing two for a typical Qpac2/ 
Hotkey boot file. Qpac2 can accommodate 


both memory resident applications (using 
HOT_RES) and non-memory resident ap- 
plications (using HOT_LOAD). Pressing 
ALT P is all that it takes to run PAS 
everytime with ease. Running from 
RAMdisk is extremely fast and benefits 
from Opac2 / Hotkey environment. 


Only compaints 


I have used ProPascal on my QL for a 
couple of years now and my only com- 
plaints about the implementation have 
been: 

¢ Lack of debugger / monitor to help find 
bugs in Runtime code or to aid in trapping 
errors 

¢ Lack of DIR command within the Pas- 
cal extensions 

¢ Ability to compile fully without the 
need of PRL. No PRL to install. Although 
there is no royalty problem with the soft- 
ware PRL being included in any commer- 
cial software you write 

* Executing a Pascal produced program 
results in a default window opening — this 
is needed to display possible runtime er- 
rors. However, it would have been nice to 
have a utility that would let you reposi- 
tion/reduce this window without having 
to load the BIN file into your editor and 
changing from there. This includes con- 
verting the width to its hexadecimal Isb/ 


msbcomponents, for instance 480 becomes 
EO (capslock) and 01 (CTRL A). 

Althougha bit pricey considering there is 
no editor or symbolic debugger, ProPascal 
is an excellent implementation and very 
powerful to boot. Ideal working environ- 
ment must include Qpac2/Hotkey with 
ram expansion. As far as | am concerned it 
isthe only way to progress from SuperBasic 
because of the similarities. The prospect of 
re-using the programs I write, if lever have 
to upgrade to say another computer, ie OS/ 
2 or Unix machine, is an appealing thought. 

Prospero Software provide excellent tech- 
nical backup of their products and pro- 
duce free Pronews magazines every four 
months to those that register with them. 
| Aside: Propascal (CPM) runs fine under 
Success the CPM emulator from DP.] Lastly, 
Listing three provides an example of how 
easy it is to produce two new commands — 
PEEK _W and PEEK _L like that provided 
by SuperBasic. 


INFORMATION 

Program: ProPascal (mmq 1.17 and PRL 
rom V1.51 ) 

Price: £101.50 

Supplier: Prospero Software, 
Castelnau, London, SW13 9DH 
Supplier: TK Computerware, Stone 
Street, North Stanford, Ashford, Kent, 
TN25 6DF 

Tel: (0303)-81-2801 


190 


FRANCE NORWAY ‘ENGLAND _ fm SCOTLAND 


QL Contact France. Contact: Jean- 
Louis Dianoux, 38-40 Rue 


Norwegian All Sinclair Association 


Quanta (UK) Membership Secre- 


Scottish OL Users Group Contact: 
AlanPemberton,65 Lingerwood Rd., 


“BELG! 75018 Paris, France. 


Club Sinclair BruQsL (Belgium) 
Contact: Jaques Tasset, Aarlenstraat 
104, 1040 Brussels, Belgium 


International OL Conference bul- 
letin board system (Swedish and 
English). Contact: Michael 
Cronsten, System Operator, Jamten- 
TCL, S Soere 1073, 83030 Lit, Swe- 
den. 


New England Sinclair QL User 
Group (USA) Membership Secre- 
tary: Sherm Waterman, PO Box 
8763, Boston, MA 021148763, USA. 
Magazine: NESOLUG News. Edi- 
tor: Peter Hale, 195 Central Ave., 
Chelsea, MA 02150, USA. 


(NASA) Contact P Monstad, NASA, 
N-5580 Oelen, Norway. Magazine: 
Sinclair Magazine. 


ITALY 


Qitaly Club Chairman: Roberto 
Orlandi, Via Brescia 26, 25039 
Travagliato (BS), Italy. Tel. (local) +39 
30 6863311. Magazine: Qitaly Maga- 
zine. Editor: Dr Eros Forenzi, Via 
Valeriana 44, 23010 Berbenno (SO), 
Italy, Tel. (local) +39 342 492323, 


TURKEY 


QL Qlub (Turkey). Contact: Bulent 
Artuz, Prof. Sites: B/1 D/5, Etiler 
80600, Istanbul, Turkey. 


AUSTRIA 


reese ge ace Contact: Pe- 
ter Postl, Stiegerg 5, 1150 Wien, 
Autstria. 
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tary, Bill Newell, 213 Manor Road, 

Benfleet, Essex SS7 4/D. Maga- 

zine: Quanta. Editor: Bill Fuggte, 
20 Widnes Avenue, Selly Oak, Bir- 
mingham B29 6QE. 


Bristol sub-group: Roy 
Brereton, 94 Teignmouth Rd, 
Clevedon, Avon BS21 6DR. 


Essex sub-group: Dave Walker, 
22 Kempton’s Mead, Potters Bar, 
Herts EM6 3HZ. 


London sub-group: Jeremy 
Davis, 6 Elmcroft Crescent, Har- 
row, Middlesex HA2 6HN. 


Northern Ireland: Billy 
Turkington, Fairyhill, Rostrevor, 
Newry, Co., Down BT34 3BB. 


Qubbesoft PD library. Contact: Ron 
Dunnett, 38 Brunwin Rd, Rayne, 
Braintree, Essex CM7 5BU. 


Newtongrange, Midlothian EH22 
400. Newsletter. 


Sin_QL_Air (Netherlands) Mem- 
bership Secretary: Bob Visser, 
Snelrewaard 6,29045N Capelle,a/ 
d Jjssel, Netherlands. Magazine: 
Quasar. Editor: C H M Biemans, 
Elzenstraat 5, 5461 CL Veghel, 
Netherlands. 


GERMANY 


Sinclair QL User Club eV (Ger- 
many) Foreign Contact: Franz 
Herrmann, Talstrasse 271, d-W5460 
Ochenfels, West Germany. Maga- 
zine; Quasar, 


Qliper Editor: Marcos Cruz, Aca- 
cias44,28023 Madrid, Spain. Maga- 
zine: Oliper. 
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example program. 


n this series, we are building up a 
library of small chunks of assembler 
language code. Each of these willdoa 
recognisable job within a program, and 
be fully annotated, so that it will be clear 
exactly how to join them to other chunks of 
code to make a program and, in particular, 
how to make any necessary changes to 
make the chunks fit together. 

In part 3, we saw how to handle screen 
output control (at least all that we could 
without using floating point numbers). 
Now to try some of this out: clearly a 
simple demonstration of visual effects is 
not going to result in a very useful pro- 
gram. But then | am not so much trying to 
give you programs, as the means to pro- 
duce your own! What | shall do is demon- 
strate some interesting effects, rather than 
try to put together a useful program. 


Not a flowchart 


Once again, rather than use the flow 
chart of the professional, | will put together 
a series of statements about what the 
program should do, together with the name 
of the chunk of code to do it, and any 
important points to be made. 


1. We start with the usual “JOBSTART', 
with an appropriate job name. 
2. Next, using ‘CONSOLE’, we open a 
console channel to cover most of the screen 
(except #0), put a border and clear the 
window. 
3. Having cleared the screen of any re- 
maining garbage, we redefine a small win- 
dow, with 'WDEFINE’, position the cursor 
with ‘POSITIONCURSOR’ and print a 
message using “MESSAGE’. 


Fixing the border 


4. We want this message in a protected 
border, so we use “BORDER '’ to overwrite 
the message with a transparent border. 

5. Using "COLOURS ' three times, we 
redefine Paper, Strip and Ink, then CLS to 
clear the whole window inside the trans- 
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Pp Machine Code 
In the fourth part of this series on developing machine code skills, Alan 
Bridewell takes his routines and merges them together to make an 


Listing 1 


$A Ee AE EEE EE JE 4 EE JE EE EE HEE HE IEE A ASE IIIT IIIT IE IEEE 
; ‘JOBSTART ' 
; 


BRA.S START 3 BRANCH TO START OF CODE 
De.L 0 3 {THIS IS STANDARD FORMAT FOR 
Cc. Ww S4AFB 3 START OF A JOB) 

—-7- ALTER CHARACTER COUNT AND JOB NAME ---— 
DC.W 7 3 CHARACTER COUNT OF JOB NAME 
DC.B "DISPLAY ' 3 NAME OF JOB 


(FE ETRE YE FE ERIE HEE JE YE HE EE E98 EE J EE EE HE EE EEE EE TEE EE EE TE RIE EEE IE HE 
“CONSOLE * 


5 OPEN THE CONSOLE CHANNEL 


ALTER LABEL TO .START ---- 
LEALL PBLOCK,Al1 ; PBLOCK ADDRESS IN At 
MOVE. W $06, A2 ; UT_CON VECTOR IN AZ 
JSR (A2) ; 

5 

SAVE THE CHANNEL ID WHICH UT_CON ROUTINE LEAVES IN Ad, 

MOVE.L AO ,- (a7) ; SAVE CONSDLE ID ON STACK 

; * NOTE * THIS CHANGES A7 

; BY -4, READY FOR NEXT 

3 STACK ENTRY. 


5 
CLEAR THE WINDOW 


MOVE. W #$FFFF,DS 
MOVED ##20,D0 
TRAP #3. 

ALTER BRANCH ADDRESS TO WDEFL --~-- 
BRA,S WDEF1 


INFINITE TIMEOUT 
#SD_CLEAR IN DO 


SKIP BLOCK 


ALTER BLOCK TO REQUIRED WINDOW —-—~—— 

+ RED BORDER 
3 2 PIXELS WIDE 
5 BLACK PAPER/STRIP 
; WHITE INK 
5 WIDTH 

5 HEIGHT 

5 X POSITION 
5 Y POSITION 


=e 
rs 
N 


(FE He AE EE JE FE EE IE HE J EE FETE FE EE TE JE FEE EEE TEE HE AE EE HE EE EE HE De I EE I EI A aE TE A 
“WDEF INE * 


} -~-- DELETE LINES TO ENTER ID IN AO AND TIMEDUT IN DS ~--- 
ALTER LABEL TO .WDEF1 ---- 
---~ ALTER LOAD ADDRESS TO WDEFINE1 ---- 
.WDEF 1 LEA WDEFINE1,A1 ; WDEFINE BASE IN Al 
MOVEQ #3D,D0 3 #5D_WDEFINE IN DO 
} ---- ALTER NEXT TWO LINES FOR REQUIRED BORDER ---- 
MOVER #$2,D2 ; RED BORDER 
MOVE. W #$2,D2 3 BORDER 2 PIXELS WIDE 
TRAP #3 ; 
---- ALTER BRANCH ADDRESS TO CURS —--- 
BRA.S CURS ; SKIP BLOCK 


~--- ALTER LABEL TO WDEFINE! —--- 
ALTER BLOCK TO REQUIRED WINDOW ——-~ 
-WDEF INE1 DC.W 256 3 256 PIXELS WIDE 
DC.W 40 } 40 PIXELS HIGH 
DC.w 10 + X ORIGIN 
DC.wW 5 3 ¥ ORIGIN 


| io fictiadiaiintieMataialiatadaRedataDaiahaiehaiehehataietelahetettaiatattahahstedahehstatehaiatadstahaieiatetahatatatukshshetaiaheiaiehahetaiudshe’ 
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parent border, so leaving the message in 
place. 

6. A second message in two lines is put 
into the window, using ‘MESSAGE’, 
‘MOVECURSOR’' (for a NL, CR), and 
‘MESSAGE’ again. 

7. To show the channel can be used 
again to write a message elsewhere, we 
use ‘WDEFINE' to give a new window, 
which is cleared with CLS. ‘CSIZE’ pro- 
duces larger characters, before ‘MES- 
SAGE’ writes a message in the new win- 
dow. 


WDEFINE eight times 


8. ‘WDEFINE’ is now used eight more 
times to leave a series of borders, each 
one mostly overwriting the previous one, 
for a3D effect. The final window uses CLS 
to clear, ‘CSIZE’ to produce a larger char- 
acter, and ‘COLOURS ' to change the Ink, 
before using ‘MESSAGE’ to print in the 
window. 

9. ‘COLOURS' again changes the Ink 
and ‘CSIZE' is used again to make smaller 
characters, before ‘MOVECURSOR’ is 
used three times to prepare for the last 
message with ‘MESSAGE’. 

10. The final embellishments are made 
to the display by using ‘WRITEMODE’ to 
put overwriting in XOR mode, before using 
‘BLOCKFILL’ six times to change the col- 
ours of the words on the final message. 

11. We end in the normal way by using 
‘CLOSE’ to close the channel, and 
‘ENDJOB’ to kill the job. 

Putting all that together, we get: 

JOBSTART, CONSOLE, WDEFINE, 
POSITIONCURSOR, MESSAGE, BOR- 
DER, COLOURS, COLOURS, COLOURS, 
CLS, MESSAGE, MOVECURSOR, MES- 
SAGE, WDEFINE, CLS, CSIZE, MES- 
SAGE, WDEFINE, WDEFINE, WDEFINE, 
WDEFINE, WDEFINE, WDEFINE, 
WDEFINE, WODEFINE, CLS, CSIZE, 
COLOURS, MESSAGE, COLOURS, 
CSIZE, MOVECURSOR, 
MOVECURSOR, MOVECURSOR, MES- 
SAGE, WRITEMODE, BLOCKFILL, 
BLOCKFILL, BLOCKFILL, BLOCKFILL, 
BLOCKFILL, BLOCKFILL, CLOSE, 
ENDJOB 
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YSTEMATIC MACHINE CODE 


‘POSIT IONCURSOR * 


5 
5 
3 


-—--- DELETE LINES TO ENTER ED IN AO AND TIMEOUT IN D3 ---- 
.CURS MOVED ##10,D0 3} #SD_POS IN DO {CHARS} 
j —--- ALTER NEXT TWO LINES FOR REQUIRED ROW AND COLUMN -—--— 
MOVE.# #%6,D1 

MDVE.W #0 ,D2 

TRAP #3 


hha clihahiatahahaliataatatahetahetahedatahehahehalishsteheladehetahehihehediieheheheiahelahaiehaiedatdadehshahahedaislolehadahedeiadaiehsiaiahadel 
“MESSAGE ° 


——-~ ALTER LOAD ADDRESS TO MESSAGE1 —--- 
—~-~ DELETE LINE TO ENTER ID IN AO —-—- 
LEA.L MESSAGE1,Ai 3 BASE ADDRESS IN Ai 
MOVE.W $DO,A2 3 UT_MTEXT VECTOR IN AZ 
JSR (a2) ; 
ALTER BRANCH ADDRESS TO BORD ---- 
BRA.S BORD 3 SKIP MESSAGE 


---~ ALTER LABEL TO MESSAGE1 ---- 
---- ALTER TO REQUIRED CHARACTER COUNT AND MESSAGE --~— 


3 
« MESSAGE 1 DC.W 29 3 LENGTH OF MESSAGE 
DC.B “THIS 15 A MESSAGE IN A BORDER’ ; 


JESSIE HIE TEI HIF TET III TEI TEI TEI EIR IEEE 
“BORDER * 


---- DELETE LINES TO ENTER ID IN AO AND TIMEOUT IN D3 —--- 
» BORD MOVEQ #$C ,DO 3 #SD_BORDER IN DO 
$ —~-- ALTER NEXT TWO LINES TO REQUIRED BORDER COLOUR AND WIDTH ~--- 
MOVEO #$80,D1 3; BORDER TRANSPARENT 
MDVE. W #$A,D2 3 BORDER 10 PIXELS WIDE 
TRAP #3 ; 


9 AEE AEE EE TE HE EEE JE JE JE FEE SE E-SERIES EEE TE IEE SEG EES EE EE EE i i i a 
‘COLOURS’ 


---- DELETE LINES TO ENTER ID IN AO AND TIMEDUT IN D3 ~-— 
MOVEQ #$27,D0 ; #SD_SETPA IN DO (PAPER) 
MOVE. B #7 ,D1 ; WHITE PAPER 
TRAP #3 3 


Fe TE EAE TE EEE SEE JE EE TE EE EEE EE EE TE EE EE ETI IIE IIIE IEEE THE 
“COLOURS * 


---~ DELETE LINES TO ENTER ID IN AO AND TIMEOUT IN D3 ---- 
3 ---- ALTER MOVED COMMAND TO #$28,DO FOR STRIP —~-~- 
MOVE® #$28,D0 ; #SD_SETST IN DO (STRIP) 
MOVE. B #47,D1 3 WHITE STRIP 
TRAP #3 3 


FETE PEE ERE IE EEE EE EE ee J EE EE EE EI TEE Ee 


3 ~>-~ DELETE LINES TO ENTER ID IN AO AND TIMEDUT IN D3 ~~-~ 
§ ———7> ALTER TO MOVEG #%297,D0 FOR INK -—--— 

MOVEQ #297, DO ; #SD_SETIN IN DO (INK) 
5 ----— ALTER TO MOVE.B #%2,D1 FOR RED ---—- 

MOVE.B #$2,D1 3 RED INK 

TRAP #3 3 


3 
RPT IE ve FE ae E96 FE aE HE DEE TH I HE HE EE EH HI EE 
5 ‘CLS* 


i 
j --~- DELETE LINES TO ENTER ID IN AO AND TIMEOUT IN D3 ---- 
MOVEQ #$20,DO 3} #SD_CLEAR IN DO 
TRAP WS 3 
i 
| Til ode hahah oletiahediadaReteRatedetedehetudhetatalietaietehetelsheledahehalshstehaialeieheheleheReheReRelelaiehehedteiaieiaisislehaheheiahshahaiel 
; “MESSAGE * 
i 
yj ---- DELETE LINE TO ENTER ID IN AO ---- 
3 ---- ALTER LOAD ADDRESS TO MESSAGE2 ---- 
LEA.L MESSAGE2,A1 5; BASE ADDRESS IN At 
MOVE. W $DO0,A2Z 3 UT_MTEXT VECTOR IN AZ 
JSR (A2) 3 
3 —-~- ALTER BRANCH ADDRESS TO MCURS -~-- 
BRA.5 MCURS 3 SKIP MESSAGE 
3 
} ---- ALTER LABEL TO MESSAGE2 ---- 
} —--~ ALTER TO REQUIRED CHARACTER COUNT AND MESSAGE ---— 


3 
» MESSAGE2 DC.W 36 3} LENGTH OF MESSAGE 
DC.B BUT THIS 15 IN THE REMAINING PART ‘ 4 


i 
Pi adhedecdhetedehehetehedehetetehededeteteteeiatetetetelshetedohetekshehelshoheheteiahelshahetehshahedhehedsbedaiehahahelaiabehaheiahahahohed 
3 ‘“MOVECURSOR * 
5 
j ---- DELETE LINES TO ENTER ID IN AO AND TIMEQUT IN DS --- 
«MCURS MOVEQ #$12,D0 5; #SD_NL IN DO (CR,LF) 
TRAP #3 H 


i 
Wi okedohedohahedehehehatahehehehshaheiehahaehaiedeiahuhahehedsladehahahaiahehaieiadahahahehshaheileiohahaiateishetehehehahstelehsheahaiehshed 
3 ‘MESSAGE * 


i 
3 ---- DELETE LINE TD ENTER ID IN AO -~-~ 


Now comes the job of making all the 
small alterations needed to make the 
chunks fit together as a program. They 
are basically as follows: 


Unique labels 


1, Make sure all the definition blocks in 
‘CONSOLE’, ‘WDEFINE’ and 
‘BLOCKFILL’ have unique labels, and they 
are altered in the LEA command to match. 
Similarly, ‘MESSAGE’ musthave aunique 
label for each message. 

2. Each time there is a definition block or 
a message, it must be skipped over with 
the BRA.S command. So the following 
chunk must be given a unique label 
matching the BRA.S command. 

3. All the definition blocks and messages 
must have their data adjusted as appro- 
priate. 

4. All unwanted comments should be 
removed. 

5. As we have a succession of trap #3 
calls using the same channel, the channel 
ID in A1 and the infinite timeout in D3 
remain unaltered, so they do not need to 
be entered repeatedly. They can be de- 
leted every time they occur except the first 
time. 

lf you have a printer, you could have a 
printout of the merged chunks of code, and 
then make alterations to this by hand, 
before altering the actual program. Alter- 
natively, you can alter each chunk of code 
as itis merged into your listing file. Listing 
one shows the results of this work, but with 
two differences. In order to show how the 
final listing relates to the merged chunks of 
code, it contains the following rows of 
asterisks left between each chunk and 
additional comments, added to show where 
the code needs to be changed. These 


comments start and end with “——". 


Through the steps 


Wewill now go through the steps needed 
to be carried out if we were going to merge 
the chunks and alter them as we merge 
them. For the sake of brevity, | shall leave 
out any instructions for tidying up the 
listing by removing unwanted remarks, 
because they don't actually affect the code. 

1. Merge ‘JOBSTART’ into the file, and 
alter the character count and job name. 

2. Merge ‘CONSOLE’ into the file. Alter 
the first label to START and the branch 
address to WDEF 1. Alter the window block 
to the required parameters. 

In all the following steps that involve 
merging TRAP #3 calls into the file (thatis, 
all the merged chunks except the 6 times 
‘MESSAGE’ occurs, and the ‘CLOSED’ 
and ‘ENDJOB' at the end), you can delete 
the two lines to put the channel ID in AO 
and the timeout in D3. This is not strictly 
necessary, butif you don’t do it, the listing, 
and the code, will be considerably longer, 
and possibly run noticably slower. 


-~-- ALTER LOAD ADDRESS TO MESSAGES --~- 
LEA.L MESSAGES,A1 ; BASE ADDRESS IN Al 
MOVE. WwW $DO,AZ 3 UT_MTEXT VECTOR IN AZ 
JSR (A2) ; 

---- ALTER BRANCH ADDRESS TO WDEF2 ----— 
BRA.S WDEF2 


—-~- ALTER LABEL TO .MESSAGES ---— 
--~- ALTER TO REQUIRED CHARACTER COUNT AND MESSAGE -—-~— 


3 SKIP MESSAGE 


MESSAGES 3 LENGTH OF MESSAGE 


DE.W 26 
; OF THE WINDOW’ ; 


DC.B 


MEE HE HE HE IE HEE HE EE HE ETE EE GEE AE AE EE EE EEE EE TEE IE EE EE HEE EER HET aE EEE 
"WDEF INE * 


---— DELETE LINES TO ENTER ID IN AO AND TIMEOUT IN D3 ---- 
---- ALTER LABEL TO WDEF2 ---~ 
---- ALTER LOAD ADDRESS TO WDEFINE2 ---- 
LEA WDEFINE2,A1 ; WDEFINE BASE IN Al 
MOVEa #$D,D0 } #SD_WDEFINE IN DO 
~--~ ALTER NEXT TWO LINES TO REQUIRED BORDER ---- 
MOVEQ #$2,D1 3 RED BORDER 
MOVE. W #$2,D2 } BORDER 2 PIXELS WIDE 
TRAP “3 3 
---- ALTER BRANCH ADDRESS TO CLS2 ---- 
RAS cLs2 


—--- ALTER LABEL TO WDEFINE2 --~— 


5 SKIP BLOCK 


3 ---- ALTER BLOCK TO REQUIRED WINDOW -——-— 


- MESSAGES 


WDEF INE2 DC.W 256 
DC.W 24 
DC.W 100 


DC.W So 


5 256 PIXELS WIDE 
3 24 PIXELS HIGH 
5 X ORIGIN 

5 Y ORIGIN 


HEHEHE HEHE HEE ETE HE HEHE TE HE REE EE EE EE HEH HH HE EE EEE EE EE EE EH I HE 
‘CLS' 


---- DELETE LINES TO ENTER ID IN AO AND TIMEOUT IN D3 ---- 
---- ALTER LABEL TO .CLS2 ---- 
MOVEQ #$20,D0 4 #SD_CLEAR IN DO 
TRAP #3 ; 


9 EE EE AE FETE IEE TEESE FEE IEE JE SE JE JE TEE SE EEE i A I EGE EE IEE RIA ERE i HR fe ab 
“CSIZE° 


—--- DELETE LINES TO ENTER ID IN AO AND TIMEOUT IN D3 --- 
MOVEQ #$2D,D0 5; #SD_SETSZ IN DO 

=--- ALTER NEXT TWO LINES FOR REQUIRED CSIZE ~~-- 
MOVE. W #$0,D1 ; WIDTH 5 IN & PIXEL SPACE 
MOVE. W ##1,D2 } HEIGHT 18 IN 20 PIXEL SPACE 
TRAP #3 ; 


TEE IEEE EEE JE JE JETER III TEETER TEETER IIE IE TEETER EI IIE JE IIE SEITE JER HEE HE 
“MESSAGE * 


---- DELETE LINE TO ENTER ID IN AQ ---~— 

---- ALTER LOAD ADDRESS TO MESSAGE4 ~—-— 
LEA.L MESSAGE4,A1 ; BASE ADDRESS IN Al 
MOVE .W #D0,A2Z 5 UT_MTEXT VECTOR IN AZ 
JSR (A2) 5 

---- ALTER BRANCH ADDRESS TO WDEFS ---- 
BRA.5S WDEFS 5 SKIP MESSAGE 

---- ALTER LABEL TO .MESSAGE4 ---- 

---- ALTER TO REQUIRED CHARACTER COUNT AND MESSAGE --~- 

DC.W 33 ; LENGTH OF MESSAGE 

bc.B 7 HERE 1S THE WINDOW REDEFINED’ ; 


Fe Ee EE TE IEEE EE JE EE TEE FEE TE EIT TE TERETE ICICI EFI IEE JE EE EEE TEE AEE TE HE PE HE 
“WDEF INE’ 


~--- DELETE LINES TO ENTER ID IN AO AND TIMEOUT IN D3 ---- 
---- ALTER LABEL TO .WDEF3 ---- 
---- ALTER LOAD ADDRESS TO WDEFINES ---- 
WDEFS LEA WDEFINES,A1 } WDEFINE BASE IN Al 
MOVEQ ##D,DO 3 #SD_WDEFINE IN DO 
---- ALTER NEXT TWO LINES FOR REQUIRED BORDER ---- 
MOVEQ #¢2 Dt 3 RED BORDER 
MOVE. Ww #64 ,D2 } BORDER 4 PIXELS WIDE 
TRAP #3 ; 
---- ALTER BRANCH ADDRESS TO WDEF4 ---- 
BRA.S WDEF4 3 SKIP BLOCK 


---~+ ALTER LABEL TO .WDEFINES ~—---— 

---- ALTER BLOCK TO REQUIRED WINDOW ---- 

WDEF INES DC.W 130 3 130 PIXELS WIDE 
DC.W 25 5 25 PIXELS HIGH 
DC.W 100 3 X ORIGIN 
DCc.W 75 5 Y ORIGIN 


‘FRE RE A Ae iE ME eA AE HE HE HE HE SE EH TE Te HE EE EI J TE DE i a a 
“WDEF INE’ 


DELETE LINES TO ENTER ID IN AO AND TIMEOUT IN D3 ---— 
ALTER LABEL TO .WDEF4 -~-~ 
ALTER LOAD ADDRESS TO WDEFINE4 ---- 
LEA WDEFINE4,Al 3; WDEFINE BASE IN Al 
MOVEQ #4D,D0 3 #SD_WDEFINE IN DO 
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j —-—-~ ALTER NEXT TWO LINES FOR REQUIRED BORDER ----— 
MOVEQ #$4,D1 » GREEN BORDER 
MOVE.W } BORDER 4 PIXELS WIDE 
TRAP 3 

3} -~-- ALTER BRANCH ADDRESS TO WDEFS ---- 
BRA.S WDEFS } SKIP BLOCK 

3 

3} —--~- ALTER LABEL TO WDEFINE4 -—--- 

} ---- ALTER BLOCK TO REQUIRED WINDOW ---~ 

» WDEF INE4 DC.W 140 3 140 PIXELS WIDE 
DC.W 30 3 30 PIXELS HIGH 
DC.W 105 3 X ORIGIN 
DC.W 80 3 Y ORIGIN 


96-4 I a ae aE AE HE I IE IE IE FE FEE ETE HE HE JE EE TE IEE HE EEE EE IE EE 9 EE AEE JE JE 8 EE aE EE EE a HE 
‘WDEF INE‘ 


---- DELETE LINES TO ENTER ID IN AO AND TIMEOUT IN D3 -~-- 

---- ALTER LABEL TO WDEFS ---- 

---- ALTER LOAD ADDRESS TO WDEFINES ---- 

.WDEFS LEA WDEFINES,A1 3 WDEFINE BASE IN Al 
MOVEQ #$D,D0 } #SD_WDEFINE IN DO 

} ---- ALTER NEXT TWO LINES FOR REQUIRED BORDER ---—- 
MOVED #$4,D1 } WHITE BORDER 
MOVE. W #44 ,,D2 } BORDER 4 PIXELS WIDE 
TRAP #3 ; 

} ---- ALTER BRANCH ADDRESS TO WDEF&é ---- 

BRA.S WDEF 6 } SKIP BLOCK 


; 

} ---- ALTER LABEL TO .WDEFINES —--- 

} ---- ALTER BLOCK TO REQUIRED WINDOW —--- 

.WDEF INES ; 150 PIXELS WIDE 
3 35 PIXELS HIGH 
3 X ORIGIN 
3 Y ORIGIN 


EEE AEE IEE SE EE J i AE IE FE EE JE JE FEE EE J EE FE JE JE ESE ETE TEE TE JE AE FEE FETE IE SEI HE ET SE JE TE TEE TE FE HE HEHE 
"WDEF INE“ 


DELETE LINES TO ENTER ID IN AO AND TIMEOUT IN D3 --~- 
ALTER LABEL TO .WDEF& —-~- 
ALTER LOAD ADDRESS TO WDEFINES ---- 
LEA WDEFINES,At ; WDEFINE BASE IN Al 
MOVE #$D,D0 3 ®SD_WDEFINE IN DO 
ALTER NEXT TWO LINES FOR REQUIRED BORDER ---- 
MOVEO #$2,Dt ; RED BORDER 
MOVE.W = -#$4,D2 3 BORDER 4 PIXELS WIDE 
TRAP #3 ; 
} ---- ALTER BRANCH ADDRESS TO WDEF7 ---- 
BRA.S WDEF7 3 SKIP BLOCK 
3 
3 ---- ALTER LABEL TO WDEFINES ---~ 
}_---- ALTER BLOCK TO REQUIRED WINDOW —-—~ 


«WDEF INEG Dc.wW 160 3 160 PIXELS WIDE 
DC.W 40 3 40 PIXELS HIGH 
DC.W i115 3 *% ORIGIN 
DC.W 99 3 Y ORIGIN 


SE ETE EE EE ESE GE EE EE J EE EE EE a AE J EE HE EE 
‘WDEF INE * 


DELETE LINES TO ENTER ID IN AO AND TIMEOUT IN D3 ---- 
ALTER LABEL TO .WDEF7 ---~ 
ALTER LOAD ADDRESS TO WDEFINE7 -~-- 
LEA WDEFINE7,Al ; WDEFINE BASE IN Al 
MOVEQ #2D,D0 3 #SD_WDEFINE IN DO 
ALTER NEXT TWO LINES FOR REQUIRED BORDER ---~ 
MOVER #$4,D1 } GREEN BORDER 
MOVE. W #%4,D2 3 BORDER 4 PIXELS WIDE 
TRAP #3 ; 
} ~--- ALTER BRANCH ADDRESS TO WDEF@ ---- 
BRA.S WDEFS 3 SKIP BLOCK 
; 
} ---- ALTER LABEL TO WDEFINE7 ———— 
} ---- ALTER BLOCK TO REQUIRED WINDOW ---- 
» WDEF INEZ $ 170 PIXELS WIDE 
3; 45 PIXELS HIGH 
; X ORIGIN 
3 Y ORIGIN 


FEES EE TEI EE A EE JIE EEE EE FEE FETE JE AE EFA E IE TEEHE JE ETE HE Ae EEE SEE ETE TEI TE TE EE 
“WDEF INE* 


DELETE LINES TO ENTER ID IN AQ AND TIMEOUT IN D3 ---- 
—-+- ALTER LABEL TO .WDEF8 ---- 
} ---- ALTER LOAD ADDRESS TO WDEFINES ---- 

LEA WDEFINE@,A1 ; WDEFINE BASE IN Ai 
MOVEQ #D,DO ; *#SD_WDEFINE IN DO 

ALTER NEXT TWO LINES FOR REQUIRED BORDER -—--- 
MOVEQ #$6,D14 ; WHITE BORDER 
MOVE.W #$4,D2 } BORDER 4 PIXELS WIDE 
TRAP #3 ; 

ALTER BRANCH ADDRESS TO WDEF9 ---- 
BRA.S WDEF? ; SKIP BLOCK 


5 
3 —--- ALTER LABEL TO .WDEFINES —--~ 


; ALTER BLOCK TO REQUIRED WINDOW ——~-— 
« WDEF INES DC.W 180 3 180 PIXELS WIDE 
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3. Merge 'WDEFINE’ into the file. Alter 
the first label to \WDEF1, and, in the same 
line, alter the load address to WDEFINE1. 
Alter the branch address to CURS. Alter 
the block label to .WDEFINE, and alter the 
block to the required window parameters. 

4. Merge ‘POSITIONCURSOR' into the 
file. Alter the two lines putting the column 
and row numbers in D1 and D2. 

5. Merge ‘MESSAGE’ into the file. Alter 
the load address to‘ MESSAGE1’. Alter the 
branch address to BORD. Alter the mes- 
sage label to MESSAGE}, and alter the 
character count and message to fit require- 
ments. 

6. Merge BORDER into the file. Alter the 
two lines putting the border colour and 
width in D1 and D2. 


Three times COLOURS 


7. Merge three copies of ‘COLOURS ' into 
the file. The first can stay as itis to set white 
paper. Alter the second to put $28 in DO for 
white strip. Alter the third to put $29 in DO 
and 2 in D1 for red ink. 

8. Merge ‘C1s' into the file. 

9. Merge ‘MESSAGE’ into the file. Alter 
the load address to MESSAGE2. Alter the 
branch address to MCURS. Alter the mes- 
sage label to MESSAGE2, and alter the 
character count and message to fit require- 
ments. 

10. Merge ‘MOVECURSOR ' into the file. 

11. Merge ‘MESSAGE’ into the file. Alter 
the load address to MESSAGES. Alter the 
branch address to WDEF2. Alter the mes- 
sage label to MESSAGE3, and alter the 
character count and message to fit require- 
ments. 

12. Merge ‘WDEFINE’ into the file. Alter 
the first label to .WDEF2, and, in the same 
line, alter the load address to WDEFINE2. 
Alter the branch address to CLS2. Alter the 
block label to .WDEFINE2, and alter the 
block to the required window parameters. 

13. Merge ‘Cls' into the file. 

14. Merge ‘CSIZE’ into the file. Alter the 
two lines putting width and height in D1 and 
D2. 

15. Merge “MESSAGE into the file. Alter 
the load address to MESSAGE4. Alter the 
branch address to WDEF3. Alter the mes- 
sage label to MESSAGE4, and alter the 
character count and message to fit require- 
ments. 


WDEFINE again 


16. Merge eight copies of 'WDEFINE’ into 
the file. Alter the first labels to .WDEFS, 
WDEF4, etc. .. .up to WDEFA, and, in the 
same lines, alter the load addresses to 
WDEFINES, WDEFINE4, etc. . . . up to 
WDEFINEA. Alter the branch addresses to 
branch to the next chunk, so they become 
WDEF4, WDEFS, etc, except the last 
branch address, which becomes CLS3. 
The block labels follow the same pattern as 


£ + 
woona aaa ! ta‘ zee g"SA0H REE EH EE EE ERE EERE eee f 
—--- yno09 G3yINnasu O1 3NI7 LX3N yay ——-- ¢ , 
oad NI 113 ase = oa‘ azse O3A0H ; 
tw NI "d07a 4O ssauday asva ! Ty‘ pxoo7d wn vy Tae" ANI NOVI 
—--- pxQO7d OL SSau¥aay avol uBiw —--- # as 
ee pT OL W3a07 wsLW --—- = OINI) OG NI NILSS ase# § 
--=- £0 NI LNOZWI1 ONY OW NI GI ¥3LN3 OL SSNIT 313730 ---- § =---~ ANI 4O4 oc ‘ozse# Of BSA0W HEL t 
TU 439078. : —--- £4 NI LNOSWIL GNY OV NI GI 4BLN3 Ol S3NIT aLa7a0q ---- 
ARKHAM ER RR EEE AEE EER EKA SERRE HEARSE E HEE EE ESR EH ER EEE : : 
4 . Synod, : 
OZ=A £ - EERE A REE A EERE ER EEE REE EER EE ER EEE RER ET EH 
ws=x § 
HOIH STaXId oz ! 4 eae 
BOIM STAXId #z vz 4°30 ena078* 30vdS T3XId OZ NI 8t LHOTSH za‘ tse 
---— ygO1a agayineay o: wsiqv ---- | 30vd5 TaXIid 9t NI Of HLGIM Ta‘cs# 
—-=- ¢no07d" OL Wav YBLW ---- ‘: —-— 42189 GBYINOSY YOI SSNIT OM LXSN HaLW ~--- 


into the file. 
up to .BFILL6, and, in the 


Og NI 7sias as# £ oc‘dazse O3A0W 
yooma @iMs £ #71134 Ss" yud —--— £0 NI LNOSW1i ONY OW NI JI HaLN3 G1 SANIT 313730 ---- 
a--- #Tidd OL SSauddy HONVNa HBiqe -—-- | 
: o* duu .3az1sa. 
wQo 7g aLtHMm £ ta‘ose a "3A0u RAE TE A A A A EE EEE HE EEE EE JE JHE JS HE SIE SHEE EE 0 aE a a aE a ae a ge 
L--— ynoqeo aayinoad OL SNI7 Lxan uaity -——- 
og NI Tus ase! oa'azs# o3AoW _ ‘ ce a0 
Ty NI XOO7d JO SSauqqy asva ! Iv*end0 ld vat £71148" Od NI yvaTD as# § odtozs# a3A0N es73° 
---~ £x907a O1 SSauday avol Yai ---~ ---~ £579" OL T3evq yal Ww ---- 
---- £1714a OL WAV YaLW —--- ‘ ---~ £0 NI iNOSWIL GNY OV NI di MaLN3 O1 S3NI7 315730 --— 
---- $0 NI LMOSWIL GNY OV NI GI Y3LNS G1 S3NI7 315730 ---- £ 


71-0074. § Sta, 
SERIE IEE HEIR HEISE HERES SHE I HEI EME UI SEIFEEIHEEIE IERIE IEEE ! HR ERE EE Ee a Ee HERE RARER ARERR ARES OF 
H 


25. Merge ‘WRITEMODE ’ into the file. 
26. Merge six copies of ‘BLOCKFILL’ into 
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24. Merge ‘MESSAGE’ into the file. Alter 
the load address to MESSAGEE. Alter the 


branch address to WMODE. Alter the 
message label to MESSAGE6, and alter 


21. Merge ‘COLOURS into the file. Alter the character count and message to fit 


.BFILL2, etc. ... 
of same lines, alter the load addresses to 


‘MOVECURSOR’ 


requirements. 


Alter the 


£ NISTNO A 
B0vdS THXid OZ NI ST LHOISH £ 5 nrearaa x 
30vdS TaxId 9 NI S Haim Ta‘os# S HSIH ST7axid oF £ 
—<-- 37189 aay 1N93e 4O4 S3NI7 OML 1x3N 4BLqw —-- f SQIM S1aXTId OOz { * WaNId30mM" 
oad NI zSias ase £ oa‘azs# 83A0H ---- MOGNIM GayINOSY OL NIOIG Hal Ww ---- ! 


---- £0 NI LAOSWIL GNY OW NI GI Y3LN3 OL SANIT 3L313ad ~--~ i —--~ W3NI430M" OL T3807 4Site --— F 
t 


and alter the 
copies 


. 32180, s woo7ta dius ! 279 s"yud 
FETTER MEN AE AEE IE SEN EEE HE HE SE FE AE A A AE AE SE JE aE SR SR AE SE IR A EEE SEE TRE TEE EAE EEE TE TEE TEE IEE ' rated €S70 OL sSaucay HINUMA HSLW ---- f 


‘ink’ and ‘green’ into 


‘MESSAGES’. 
three 


‘ 30IM STaXId * yaquoa ! 
YNI nagua f ; yaduod Nasue ! 
og NI Wis ase £ ---- 4a0d408 (3yINOSY 4O4 SSNIT OML LKBN YSiqWw --— § 
Ty NI 007d 30 sSauqay asva ‘ eat e OG NI 3NI430M as# : oa‘ ase aaA0W 
---- ZNdO7d O1 SSayday avol 43a1Wv --—- te NI 3S¥a SNI430m ! Ty'WSNI 430M wa v4aaM* 
---- ZT114a OL TWaav7 4aLWw ---- ---- V3NI430M OL SSSuddy advO7 YaLW ---- 
--— SQ NI LNOAWIL ONY OV NI QI Y3iN3 OL SSNI1 313730 ---- ---- v4a30M* OL 13a07 yal --— 
. rao. : —--- £0 NI iNO3WIL GNY OV NI 1 Y43.N3 O01 SSNI7 31a573aq ---- § 
HERP OAH DE HE EAE AE AE Ae 9 Ee FE EF SE 40 aE aE HE HE EAE RE HEE EE SEE AE HEHE ETE HEE REE EE ETE HEH HEHE EE HEE : ‘ 


SSAGES’ 
character count and message to fit re- 


quirements. 
Merge 


. NT ARM. 
OZ=A & = OH HE aE He HE 9 4 40 9 eee 
onx 

HOIH STaxXId oz ¢ % NIOIHO A # 
SQIM Staxtd Bt a T0078 * NISTYO xX £ 
~-— 19078 G3HINOSY OL Hal ---- § HOIH ST3XId SS ! 
=== }NOOT8" O41 TWHae7 waite ---- ! 30ImM S1axXId ost ¢ e 43N1430M~ 
‘ -——— MOGNIM GSYINDSY OL ADIOV ywaiWw ---- & 
woO7a dius £ znisa s "uaa -——- 63NIS30mM" OL W387 NSiW ---- F 
~--- ZTII4a OL SS3NdGY HONVYa NaiTy ——-- § { 
t 2# avy wao1a dims ¢ va30mM Ss "vua 
ugo7g dau £ 1a‘zse 8" 3A0W —--- ¥d50M 01 SSSYUddY HONVYd YaLTW ---- Ff 
<--- 4N0709 G3ayINOSY Ol 3NIT LxXSN YSiW ---- § £ <* veh 
og NI 1113 ase oa* azs# O3A0W BQIM STaxXid » “uBauoa | Za‘ vse °SA0H 
Ty NI ’OO7a 4O SS3uday asva § Ty‘ INOO7E vat tTWisa* waquod aay ta‘zee 93A0W 
~--- Txd07@ OL ssaucay avo uBLWw ---- = ~--~ 43008 GSYINGSY YO4 SSNIT OML 1k3N NBL W --~- £ 
-—- 17148 OL Tay 4aLw ---- i od NI 3NI43qmM ase ‘ oa‘ ase o3A0W 
-=--- £@ NI LNOSWIL GNY OW NI GI ¥3IN3 O01 S3NI7 3137aq ---- Ty NI 3S¥@ SNIS30M £ Ty‘ SaNI 430m vat 643M" 
. 711440078. si —--- 63NI430M OL SS3uday avo Maiq ---- 
Ae EE EERE A AEH EE REA ESEEERASHEHREAH EERE EER : ====- £6J350M" 01 T3ay7 yalLw --— 
---- £0 NI LNOBWIL ONY OY NI GI 4SIN3 04 S3NI7 313730 ---- 


22. Merge ‘CSIZE’ into the file. Alter the 


23. 
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the load address to 
DO and D1. 
D2. 


‘ink’ and ‘black’ intoDO = twolines putting width and heightinD1and_ the file. Alter the first labels to .BFILL1, 


becoming. WDEFINE3 


i 
ONNOYWSAIvE OLNI “NI Hox { 1a‘ 4aasee s -3N1430M, 
Oa NI GWLlas# ‘ oa‘azse S00HM * EE EE A IE He EE SEH EEA A 
---- 20 NI LNOSWIt (NY OV NI GI N3iNa OL S3NI1 313730 ---- ¢ 
‘ 


‘COLOURS into the file. Alter 


NIOTUO A t 
- S00WSL TUM. t NISING x £ 
ROAST EERE ERAS ESTES REESE SEER EE REE EEE RE SEReReHEEeeEEEeE F HOIH SiaxId os § 


up to WDEFINEA. And, of course, 
alter all the blocks to the required window sage label to ‘ME 


parameters. 
two lines putting width and heightinD1 and _ the two lines putting 


17. Merge ‘CLS’ into the file. 
18. Merge ‘CSIZE’ into the file. Alter the 
20. Merge ‘MESSAGE’ into the file. Alter 


the two lines putting 


and D1. 


the load addresses 


19. Merge 


etc.... 
D2. 
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put in some underlining, 


’ 


, or recolour a whole window at some 
stage. You could use some of this to em- 


for example 


+ 


Remember, though, that this is not the 
complete armoury of screen control com- 


ing 
numbers. Happy coding! 


SYSTEMATIC MACHINE CODE 


simply copy listing 


Pererrrrrrterrrrrrrtrreecerererertrrrrrrrrrrreriititrtirrrroro lool Tt aa 
4 


£ Te ave 
Td NI aor SIH 30 a1 £ Ta't-# @3A0nW . 
oad NI gaofua LHe oa‘s# osA0n aoc aN3* 
‘ 
_ : (Z¥) ase i 
zy ut omya in ¢ zuteas M"SA0W ana aoc’ 
aoran3, 
RAE Ee ee EEE EEE EER EHH EA REAR ERE EE 


$ gor ana s"vua 
: ze due 
od NI 38079 O18 £ oa‘z# DaAoW 
--- OW NI GI Y3IN3 OL 3NIT 315730 


. 38073. 
EERE REE HER EH EEE EHER EH ER HERE EKER RHEE EKER ERA ERENT HE Ha Eat 


ozea ft m-oa 

ect=x £ "od 

HOIH SI3xXId oz m-od 
3dIM SVaxId Ze ¢ 73d 9090748 * 
---- 949078" O1 Taav7 ual ---- : 


woo7a dias 3s019 sS*vua 
---- 35075 O41 SS3udab HONYNa HaITy ---- 

§ 2# aM 

yaata ase ta‘zse g"3A0W 
--—— 4N0709 G3yINOSY OL 3NIT 1x3N yaLTy ---- § 

oa NI VWs dase § og‘azee asAow 


Ty NI 1OO7a JO SSaudady 3suva f TytoNdOId va 911146" 


$ .iMOGNIM SNO ATNO HLIM TTy aNYy . 
39YSSSM 30 HiSNa7 ¢ of 73d Fao0Ss3aH~ 
--=- SSUSSSW ONY INNOD HBLIVeVHD GayuINoSsed OL Hal WwW : 
—-—- 9SSVESSN" O1 TaEe) YBLW ---- + 


BevSSan dius ! 3qdoKm s*uua 
a 3qd0WM O1 SSaudd” HONVYs Hal —--- £ 
tzu) 
zy NI HOLOSA 1xSIW An zytods 
Tw NI SSSuaay 3sva § Ty‘ e3auSSaN 
-—-- 939VSS3W O1.SSay¥day avol yaitw —-— | 
--7- OO NI GI Y3LN3 O1 3NIT 3La73q ---- 


. S9USSSH, 
SHEE EEE HERRERA ER HE HE ME HEE EE EEE THE TE EEE ETE EEE EEE 


a 5 at ies 
¢(a7‘Ho) O@ NI TNGS# —§ = oatZIse a3A0W 
--+= £0 NI LMOSWIL ONY OV NI GI Y3LN3 OL SSNIT 3Laiaq ——- § 


. 4OSHND3A0N, 
AE EE Rg He a IE FE JE AE SE EE SEE SEE EE EEE EE EIT ETE IEE EE 


2 E oe aut 
(at*ya) og NI TN as# § oa'zise a3A0u 
-—- £0 NI LMOSWIL ONY OV NI GI Y3LN3 OL SSNIT 31373a ---- § 


. YOSHNISAAOH . 
NE Ae ae FE SHE HE IE IEE HE EEF EH EAE A I aE A EA aE JE FEE ME 


. § oe doa 
(av*yO) OG NI IN dse —§ oatzIs# o3A0W 
---— £0 NI JNOaWIL ONY OV NI GI 43LN3 OL S3NI7 3139 7ad ---~ 


. YOSHNISABH . 
JAE TE AE IE FETE FER FEA FETE FETE IRAE EE ETE EA EE IEE aE EAE EE HE EE EE EE EE ETT IEEE EEE iba a ea aa aa 


47 


---- 949078 O1 SS3udaY avo YaLW § 
—--- 9V114a OL Taav7 “ait ---- £ oz=a oz 
---- £0 NI LMOSBWIL GNY OW NI GI 43iNa OL S3NI7 315730 ---- ¢ or=x f of 
: . 771449078. HSIH S13XId oz £ oz 
EEE HERRERA EAA EG EERE EH EER EER EEERER RRA HEE EERE RE 301m S7SxId 6T f BT GB: z400 78 * 
---- 40078 G3yINOSY OL yaLWw ---- | 
oz=a " ---- 2yao7a" OL 3a" YaLW ---- 
vrt=x § = 
HSIH S13XId oz § woo7a dims § en se S"vud 
SQIM STaXId et ¢ at 70078 ~ --—— £71148 OL SSauddy HONUYE YBLTY ---- 
—--~ ~O007@ G3yInasy al wait ---- £ ‘ £* Sea 
---- Sud07a" G1 TWaav7 Yai ---- § 9078 Naas Ta‘ se @°300W 
t ---- 4N0702 G3Y¥INOIY OL 3NIT LKSN 4alWw ---- 
---- N3SYS 4Os Td'es# OL B*SA0W HBL 
OANT? OG NI NIiasS ase { oa'szse 83A0W 
---- NI 404 OG'é67## OL DAAGW NAL TY 
---— £0 NI iNOSWI4 ONY OW NI GI 43LN3 O01 SANIT 313730 


You could, of course 
program — I'm sure it can be greatly im- we shall look at those other, not so easy, 


proved! Perhaps you could try out the few screen commands, involving floating point 


of the exercise. It is much better to merge flash 
it is to put together. To show yourself that 


.up to .BLOCK6. And, of you have really understood the system, 
commands that do not come into this list- 


. except the last branch the required chunks of listing into one file, 


yoo7a dI4s § 9711144 S*yud 
---- 9V1sa GL SSauddy HONVYd HAL Te ~--- F 
£ =e ava 
woo Nasu Ff Ta‘ ese a*3A0n 
—--- 4n0709 G3yIADSY OL 3NIT LxX3N YaLte ---- Ff 
oa NI WWI4 ase § oda‘azse o3a0w 
Ty NI 3007a 40 SSaudayv asva § ty‘oujo7d vq 
—-- 50078 01 SS3xdqv avo7 yaiW 


.S¥no 703. 

e711 48° HEREHEH ER EH EE ERE AHERN EEE ER EREARRERAR EG EEE EERE HEE EEE EER EE ERREERRER F 
£ ,j8d00 a@-oa 

39USS3W 40 HISNST7 8 M*aod S39¥SS3H~ 

v->=~ BOYSSSH ONY LNNOD HSLIVeVHD GSuINGaY OL Yale ---- ¢ 

en=~ SS9VSSSN" OL 13871 Waly ---- + 


—--- STII48 OL TWaav7 Hal 
e--- £0 NI iNQ3Wil GNY OV NI GI Y3LN3 O01 S3BNI1 alataqd --—- 
. TISaD0 14. 
EAE A a ETE EEE REE EE 


. upto BLOCKE. 
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oz=, ft * SovSS3W dIns ! S103 s "vue 
wa=x { $709 01 SSSyday HONYH HSI ---~ 
H9IH STaKId oz s (zy usc 
Baim siaxia vz ¢ ZY NI HOLTS0 LxBiW un £ zy‘ous hm" SA0M 
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---- OY NI GI 43iN3 O1 3NI7 313730 


so they become BFILL2 


BFILL3, etc. . . 


BLOCK2, etc... 


soot 4I4s f sT7iiaa Ss "yu 
~~-- SVUs8 O1 SS3yddy HONVYd HSI IW 


, 389SS4SH. 


address, which becomes CLOSE. The and make the appropriate modifications. bellish the program put together in part 2 of 


block labels follow the same pattern asthe You would then come to see just how easy this series. 
course, alter the blocks to the required you could make your own changes to the mands — just the easiest ones. Next time, 


Alter the branch addressestobranchtothe one. But that would rather defeat the point or (in 8 colour mode) make some words 


load addresses, becoming .BLOCK1, 


.BLOCKk2, etc. . . 
27. Merge ‘CLOSE’ into the file 
28. Merge ‘ENDJOB’ into the file. 


next chunk 
parameters. 


BLOCK1 


Sinclair/QL World February 1992 


ETE tee oe De vet 


Ee ae CLL 


THE FIRST PC TO BREAK 
THE SOUND BARRIER. 


We gave the Amstrad pc5286®@ all the best features you need 
for serious business use and great games entertainment. 

Then we gave it features which were unheard of. 

As you'd expect, it has state-of-the-art graphics with a 14” high 
quality VGA monitor which will display up to 256 colours from a 
palette of over a quarter of a million. 

Terrific for business applications but all that colour is wasted on 
games if your sound system comes from the dark ages. 

So we gave it a sound system that makes it unique. 

Its fully ‘Ad-Lib’ compatible soundcard with its twin external 
speakers, brings you closer to the action bringing a whole new 


dimension to the PC. 
BUILT FOR BUSINESS 


We gave the PC5286@ a massive 1 Mb RAM, 40 Mb hard drive 
and 1.44 Mb 3.5" floppy disc drive. 


PRINCE OF PERSIA 


LINKS F-15 STRIKE EAGLE II 
F.R.P's correct at 1/10/91, may change without notice. © Amstrad pic October 1991. All rights reserved. 


Available from selected branches of Allders, Dixons, John Lewis, Rumbelows, Rymans, Wildings and over 3,000 registered Amstrad computer dealers. 


And when it comes to using all that storage capacity it has a fast 
80286 chip running at 16 Mhz so you'll be able to get through the 
business of the day with enough time left to play around. 


THE COMPLETE SYSTEM 


If golf isn’t your game the Amstrad PC5286 @games pack comes 
with two other great games. Together with fully featured keyboard; 
mouse, DOS 3.3 with user-friendly, graphical interface and a 
joystick. 

So at £899 + Vat (£1056.33 Inc Vat)* 
it has to be a sound business proposition. 


omar 0277 262326 [ san] MSTRAD 


DETAILS RING 

| [like the sound of the eat Please tell me more. sqLu2 
| Name : I 
| Address 
| I 
I 7 I 
[ - Postcode | 
| Coupon information may be kept on a database. This may be passed to your Amstrad | 
I dealer, if you object please tick box 


